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Congratulations on your purchase of C+O Class Libraries, Volume 1: 
Foundation Data Structures! C+O is a new kind of product called a Class 
Library. Class libraries are different from other kinds of libraries because they 
can model general purpose data structures, not just DOS interfaces or user 
interfaces. Secondly, class libraries are new because they employ object- 
oriented programming techniques. What makes this so important is that it 
establishes new levels of reusability. 

In creating C+O Class Libraries, we have always kept the following things in 
mind: 

1. Programmers are the toughest customers around — especially 
when it comes to using someone else's source code. 

2. The documentation is at least as important as the code. 

3. Debugging aids are an important mechanism for understanding 
and learning to use a library. 

4. Examples, examples, examples. 

5. A picture is worth many pages of text, many hours of debugging 
and many support calls. 

We think you will be pleasantly surprised how much we took these principles 
to heart. 

At Objective Systems, we are firmly committed to the concept of reusable code. 
C+O was originally developed for our own use in developing a variety of 
commercial products. We believe that object-oriented techniques are the 
solution to the reusability problem. 

At Objective Systems, we are firmly committed to standards. C+O is fully 
compliant with ANSI C conventions. C+O is named using SAA naming 
conventions. As standards for object-oriented programming emerge, we will 
adapt C+O class libraries to those standards as well. 

Finally, C+O is a living product. It will be continually enhanced and upgraded. 
We value your suggestions and comments and will strive to incorporate them in 
future releases. Over time, we will porting C+O to other hardware and software 
platforms as well as coming out with new libraries. Please let us know what 
you would like to see. 

Should you have any problems or questions regarding C+O class libraries, 
please give us a call. We are available from 9am to 7pm West coast time. 
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Function Name Description Page Scope Macro 



BlkClear 


Clear instance 


Blk-2 


Public 


N 


BlkDelnit 


Deinitialize instance 

WWII II UtAllfcV II IwlW Ivv 


Blk-3 


Public 


N I 


BlkExecute 


Execute method with parameters 


Blk-4 


Public 


N 


BlkExecuteRetBool 


Execute the method, return int 


Blk-5 


Public 


N 


BlkExecuteRetDataPtr 


Execute method, return mem pointer 


Blk-6 


Public 


N 


BlkExecuteRetFuncPtr 


Execute method, return function ptr 


Blk -7 


Public 


N 


BlkExecuteRetlnt 


Execute method, return int 


Blk-8 


Public 


N 


BlkHasMethod 


Return True if instance has non-NULL method 


Blk-9 


Public 


N 


Blklnit 


Initialize instance 


Blk-10 


Public 


N 


BlkPrint 


Print contents of instance 


Blk -11 


Public 


N 


BIkPushDataPtr 


Save pointer parameter 


Blk-12 


Public 


N 


BlkPushFuncPtr 


Save function pointer parameter. 


Blk-13 


Public 


N 


BlkPushLargeint 


Save Largelnt parameter 


Blk- 14 


Public 


N 


BlkPushMediumlnt 


Save Mediumlnt parameter 


Blk- 15 


Public 


N 


BlkSetMethod 


Set the function to call 


Blk -16 


Public 


N 



CIsCreateMessages 


Create the Msg instances 


N/A 




Undoc 


N 


ClsCreateObject 


Create a new Object instance 


CIs- 


2 


Public 


N 


ClsCreateSupers 


Create the superclass instances 


N/A 




Undoc 


N 


CIsDelnit 


Oeinitialize the instance 


CIS- 


3 


Public 


N 


CIsDestroy 


Deallocate the instance 


CIS- 


4 


Public 


N 


CIsDestroyMessages 


Destroy the messages 


N/A 




Undoc 


N 


CIsDestroyObject 


Deallocate the object instance 


CIS- 


5 


Public 


N 


ClsOestroySuperClasses 


Destroy the superclasses 


N/A 




Undoc 


N 


CIsRndMsg 


Find message given selector name 


CIS- 


7 


Public 


N 


CIsFindSelectorlndex 


Find index of selector given name 


CIS- 


8 


Public 


N 


CIsFindSuperClass 


Find superclass given name 


CIS- 


10 


Public 


N 


CIsGetMessageCount 


Get number of messages 


CIs- 


11 


Public 


N 


CIsGetMethodAndOffset 


Return method and sub/super offset 


CIs- 


12 


Public 


N 


CIsGetName 


Return name of the instance 


CIs- 


14 


Public 


N 


CIsGetNthMsg 


Get pointer to nth Message 


CIs- 


15 


Public 


N 


CIsGetNthSuperClass 


Get pointer to Nth superclass 


CIs- 


16 


Public 


N 


CIsGetObjectSize 


Return size of an object instance 


CIs- 


17 


Public 


N 


CIsGetOffsetForMsg 


Return sub/super offset of object 


CIs- 


18 


Public 


N 


CIsGetOffsetOfNthSuper 


Return offset of nth superobject 


CIs- 


20 


Public 


N 


CIsGetRootSubClass 


Get the root subclass 


CIs- 


22 


Public 


N 


CIsGetRootSubObjectOffset 


Return offset of root subobject 


CIs- 


23 


Public 


N 


CIsGetRootSubObjectSize 


Return size of the root subobject 


CIs- 


24 


Public 


N 


CIsGetSize 


Return size of the instance 


CIs- 


25 


Public 


N 


CIsGetSubClass 


Return subclass 


CIs- 


26 


Public 


N 


CIsGetSubObjectOffset 


Return offset of a subobject 


CIs- 


27 


Public 


N 
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Function Name Description Page Scope Macro 



CIsGetSuperClassCount 


Return number of superclasses 


as- 


28 


Public 


N 


CIsGetSuperClasslndex 


Return superclass index 


CIs- 


29 


Public 


N 


Clslnit 


Initialize the instance 


Qs- 


30 


Public 


N 


CIslsRoot 


Is instance the root subclass? 


CIs- 


31 


Public 


N 


ClsOffsetSupers 


Offset superclasses from subclass. 


N/A 




Undoc 


N 


ClsPrint 


Print the instance 


CIs- 


32 


Public 


N 


CIsSendDestroy 


Send destroy message to instance 


as- 


33 


Public 


N 


CIsSendObjectMessage 


Send object a message 


CIs- 


34 


Public 


N 


CIsSendObjectMessageRetumlnt 


Send object message, returns Medium Int 


Cls- 


36 


Public 


N 


CIsSendObjectMessageRetumPtr 


Send object message, returns Void * 


CIs- 


38 


Public 


N 


ClsSuperClassOf 


Initialize sub/super relation 


N/A 




Undoc 


N 



DIIAppend 


Append element to list 


Dll 


■2 


Public 


N 


DIIAppendLast 


Mate element last 


OH 


•4 


Public 


Y 


DIIAsObj 


Return list as object 


Dll 


•6 


Private 


Y 


DHCIear 


Clear the list 


Dll 


•7 


Public 


N 


DBCut 


Cut one element from list 


Dll 


•8 


Public 


N 


DHCutChildren 


Cut all elements from list 


Dll 


•10 


Public 


N 


DIICutRange 


Cut elements) from list 


Dll 


•11 


Public 


N 


DBDelnit 


Deinitialize list object 


Dll 


-13 


Public 


N 


DUDestroy 


Deinitialize list object and free space 


Dll 


•14 


Public 


N 


DIIGetCPent 


Return client of list 


Dll 


■15 


Public 


Y 


DIIGetFirst 


Return first element 


Dll- 


•16 


Private 


Y 


DIIGetLast 


Return last element 


Dll 


■17 


Private 


Y 


DIIGetNth 


Return Nth element 


Dll 


•18 


Private 


N 


DIIGetSize 


Get size of list 


Oil 


•19 


Public 


N 


DBInit 


Initialize list object 


Dll 


■20 


Public 


N 


DUInsert 


Insert element in list 


Dll 


•21 


Public 


N 


DlllnsertFirst 


Make element first 


Dll- 


■23 


Public 


Y 


DUIsEmpty 


Return True if list empty 


Dll 


•25 


Public 


Y 


OIILelClientCount 


Visit function: count elements conditionally 


Dll 


•26 


Public 


N 


DIILelClientRnd 


Visit search function: all elements 


Dll 


•28 


Public 


N 


OIILelClientFirst 


Return client of first element 


Dll 


•30 


Public 


Y 


OIILelClientGetNth 


Return Nth client 


Dll 


•31 


Public 


N 


DIILelClientLast 


Return client of last element 


Dll 


•33 


Public 


Y 


DIILelClientVisitBwd 


Visit function: all elements 


Dll 


•34 


Public 


N 


DIILelClientVisitFwd 


Visit function: all elements 


Dll 


•36 


Public 


N 


OIINoSfyCutRange 


Cut elements 


Dll 


•38 


Friend 


N 


DIINotifyPasteRange 


Paste elements 


Dll 


■39 


Friend 


N 


DIIPasteRangeAfter 


Paste elements) to list 


Dll 


•40 


Public 


N 


DIlPasteRangeBefore 


Paste elements) in list 


Dll 


•42 


Public 


N 


DIIPasteRangeFirst 


Paste elements) to be first in list 


Dll 


•44 


Public 


Y 


DIIPasteRangeLast 


Paste elements) to end of list 


Dll 


■46 


Public 


Y 


DHSendOestroy 


Send message for list destruction 


Dll 


■48 


Public 


N 



iv 
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DpaAppend 


Append an element 


Dpa 


-2 


Public 


N 


DpaClear 


Clear dynamic array 


Dpa 


-4 


Public 


N 


DpaCount 


Visit function: count True returns 


Dpa 


-5 


Public 


N 


DpaCountRange 


Visit function: range with return checking 


Dpa 


-7 


Public 


N 


DpaOelnit 


Deinitialize the dynamic array object 


Dpa 


-9 


Public 


N 


DpaDelete 


Delete elements) 


Dpa 


•10 


Public 


N 


DpaDestroy 


Deinitialize array object and free space 


Dpa 


-12 


Public 


N 


DpaExpand 


Paste Null elements) into array 


Dpa 


-13 


Public 


N 


DpaHnd 


Find index returning True 


Dpa 


-15 


Public 


N 


DpaFindPtrBwd 


Find index with matching pointer 


Dpa 


-17 


Public 


N 


DpaFindPtrFwd 


Find index with matching pointer 


Dpa 


-19 


Public 


N 


DpaRndRangeBwd 


Find index returning True for range 


Dpa 


-21 


Public 


N 


DpaFindRangeFwd 


Find index returning True for range 


Dpa 


-23 


Public 


N 


DpaGetLast 


Return last element in array 


Dpa 


-27 


Public 


N 


DpaGetNlh 


Return Nth array element 


Dpa 


-25 


Public 


N 


DpaGetSize 


Return number of elements 


Dpa 


-29 


Public 


N 


Dpalnit 


Initialize the edge object 


Dpa 


•31 


Public 


N 


DpaNewArray 


Create a new array 


N/A 




Undoc 


N 




nccHZu if ns array 


M/A 
IN/A 




Undoc 


M 


DpaSetNth 


Set Nth element of array 


Dpa 


•33 


Public 


N 


DpaSetRegionNull 


Make region of elements Null 


Dpa 


•35 


Public 


N 


OpaSetSize 


Set array size to N elements 


Dpa 


•37 


Public 


N 


DpaShiftDown 


Shift down N elements in array 


Dpa 


■38 


Public 


N 


DpaShiftUp 


Shift up N elements in array 


Dpa 


•40 


Public 


N 


Dpa Visit 


Visit function: all elements 


Dpa 


■42 


Public 


N 


DpaVisitClient 


Visit function: alj elements 


Dpa 


•44 


Public 


N 


DpaVisitRange 


Visit function: range of elements 


Dpa 


•46 


Public 


N 


DpaVisitRegion 


Visit function: region of elements 


Dpa 


•48 


Public 


N 


DpaVisitSelfAndSuccessors 


Visit function: client and successors 


Dpa 


•50 


Public 


N 



EdgAsGrfLel 


Return graph list element for edge 


Edg 


-2 


Friend 


Y 


EdgAslnLel 


Return incoming edge list element 


Edg 


-3 


Friend 


Y 


EdgAsObj 


Return edge as object 


Edg 


-4 


Private 


N 


EdgAsOutLel 


Return outgoing edge list element 


Edg 


-5 


Friend 


Y 


EdgClear 


Clear the edge 


Edg 


-6 


Public 


N 


EdgComparelnVtx 


Compare incoming vertex 


Edg 


•7 


Public 


N 


EdgConnectToGrt 


Connect edge to graph 


Edg 


•9 


Public 


Y 


EdgConnectToVertices 


Connect edge to vertices 


Edg 


•11 


Public 


N 


EdgDelnit 


Deinitialize the edge object 


Edg 


•13 


Public 


N 


EdgDestroy 


Deinitialize edge object and free space 


Edg 


■14 


Public 


N 


EdgDisconnectFromGrf 


Disconnect edge from graph 


Edg 


■15 


Public 


Y 


EdgDisconnectFromVertices 


Disconnect edge from vertices 


Edg 


■17 


Public 


N 



V 
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Function Name 


Description 


Page 


Scope Macro 


EdgGetClient 


Return client of edge 


Edg-19 


Public 


Y 


EdgGetGrf 


Return graph 


Edg-20 


Friend 


Y 


EdgGetlnVtx 


Return incoming vertex 


Edg -21 


Friend 


Y 


EdgGetNextln 


Return next incoming edge 


Edg-23 


Friend 


Y 


EdgGetNextOut 


Return next outgoing edge 


Edg -25 


Friend 


Y 


EdgGetOutVtx 


Return outgoing vertex 


Edg-27 


Friend 


Y 


EdgGetVertices 


Return vertices to edge 


Edg-29 


Public 


Y 


EdgHasVertices 


Does edge have any vertices 


Edg -31 


Public 


N 


EdglnGrf 


Is edge in graph 


Edg -32 


Public 


Y 


Edglnit 


Initialize the edge object 


Edg-33 


Public 


N 


EdgSendOestroy 


Send message for edge destruction 


Edg-34 


Public 


Y 


EdgUpdatelnVtx 


Replace incoming vertex 


Edg -35 


Public 


N 


EdgUpdateOutVtx 


Replace outgoing vertex 


Edg-37 


Public 


N 



GrfAnyCycles 


Check graph for cycles 


Grf-2 


Public 


Y 


GrfAsEdgDII 


Return List of edges 


Grf-4 


Friend 


N 


GrfAsObj 


Return graph as object 


Grf-5 


Private 


N 


GrfAsVtxDII 


Return List of vertices 


Grf-6 


Friend 


N 


GrfBasicTopologicalSort 


Do topological sort of graph 


N/A 


Undoc 


N 


GrfClear 


Clear the graph 


Grf-7 


Public 


N 


GriCountEdg 


Count edges of graph 


Grf-8 


Public 


Y 


GrfCountVtx 


Count vertices of graph 


Grf-10 


Public 


Y 


GrfDelnit 


Oeinitialize Graph object 


Grf-12 


Public 


N 


GrfDestroy 


Deinitialize Graph object and free space 


Grf-13 


Public 


N 


GrfDoTopologicalSort 


Do topological sort of graph 


Grf-14 


Public 


Y 


GriFindEdgCiient 


Visit search function: edges 


Grf-16 


Public 


N 


GrfFindVfcClient 


Visit search function: vertices 


Grf-18 


Public 


N 


GriGetClient 


Return client of graph 


Grf-20 


Public 


N 


Grflnit 


Initialize Graph object 


Grf-21 


Public 


N 


GrfSendOestroy 


Send message for graph destruction 


Grf-22 


Public 


N 


GrFVisitEdgClient 


Visit function: edges 


Grf-23 


Public 


N 


GrfVisitVtxClient 


Visit function: vertices 


Grf-25 


Public 


N 


GrfVisitVtxClientlnTopOrderBwd 


Visit function: backward topological order 


Grf-27 


Public 


N 


GrfVisitVtxClientlnTopOrderFwd 


Visit function: forward topological order 


Grf-29 


Public 


N 



JulAddDays 


Add/subtract days to date 


Jul -2 


Public 


Y 


JuiAddDaysL 


Add/subtract days to date (long) 


Jul -4 


Public 


Y 


JulAddMonths 


Add/subtract months to date 


Jul -6 


Public 


N 


JulAddQuarters 


Add/subtract quarters to date 


Jul -8 


Public 


N 


JulAddYears 


Add/subtract years to date 


Jul - 10 


Public 


N 


JulCalendarToJulian 


Day, month, year to julian day 


Jul -12 


Public 


N 
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JulCopy 


Copy Julian day 


Jul 


•14 


Public 


Y 


JulDateStrToJutian 


Date string to Julian day 


Jul 


■16 


Public 


N 


JulDayOfWeek 


Day number in week 


Jul 


■18 


Public 


Y 


JulDayOfYear 


Day number in year 


Jul 


•20 


Public 


N 


JulDayslnMonth 


Days in month 


Jul 


-22 


Public 


N 


JulDayslnQuarter 


Days in quarter 


Jul 


•24 


Public 


N 


JulDayslnYear 


Days in year 


Jul 


•26 


Public 


N 


JuOff 


Days between two dates 


Jul 


•28 


Public 


Y 


JulDiffL 


Days between two dates (long) 


Jul 


•30 


Public 


Y 


JulGetSystemJulianDay 


System date as Julian day 


Jul 


•32 


Public 


N 


Jullnit 


Set to beginning of calendar January 1 , 1583 


Jul 


•34 


Public 


Y 


JullsLeapYear 


Is date in leap year 


Jul 


•36 


Public 


N 


JullsMaxValue 


Is date maximum julian value 


Jul 


•38 


Public 


Y 


JulMax 


The maximum of two julian dates 


Jul 


•40 


Public 


Y 


juiMin 


Tho minimum /\i Kaja ittlion Hatnc 

i ric iTiinimurn ui two juiian QcUus 


lul 


. AO 


rUUIIC 


Y 


JulMonthDayDiff 


Days between date and a day/month 


Jul 


•44 


Public 


N 


JulMonthString 


Fill string with month and year 


Jul 


•46 


Public 


N 


JulQuarterString 


nil string with quarter and year 


Jul 


•48 


Public 


N 


JulSameDayMonth 


Two dates same day and month 


Jul 


•50 


Public 


N 


JulSetMaxDate 


Set date to maximum value 


Jul 


•52 


Public 


N 


JulToCalendar 


Julian day to day, month, year 


Jul 


■54 


Public 


N 


JulToDateStr 


Fill date string of specified format 


Jul 


•56 


Public 


N 


JulValidateDate 


Validate date passed as string 


Jul 


■58 


Public 


N 


JulWeekString 


Rll string with day and month 


Jul 


•60 


Public 


N 


JulYearString 


Fill string with year 


Jul 


•62 


Public 


N 



LeIAsObj 


Return element as object 


Lei 


2 


Private 


Y 


LeICIientCount 


Return count for client and successors 


Lei - 


3 


Public 


N 


LeOentDII 


Return client of list 


Lei - 


5 


Public 


Y 


LelClientFindRange 


Visit search function: range 


Lei- 


6 


Public 


N 


LeICIientNext 


Return client of next element 


Lei- 


8 


Public 


Y 


LeICIientPrev 


Return client of previous element 


Lei - 


9 


Public 


Y 


LeICIientVisitBwd 


Visit function: client and predecessors 


Lel- 


10 


Public 


N 


LelClientYlsitFwd 


Visit function: client and successors 


Lel- 


12 


Public 


N 


LeICIientVisitPredecessors 


Visit function: predecessors 


Lei- 


14 


Public 


N 


LelClientVisitRange 


Visit function: range 


Lei- 


16 


Public 


N 


LeICIientVisitSuccessors 


Visit function: successors 


Lei- 


18 


Public 


N 


LeICountRange 


Count elements 


Lei- 


20 


Public 


N 


LeICut 


Cut element from list 


Lei - 


22 


Public 


N 


LeICutRange 


Cut element(s) from list 


Lei - 


24 


Public 


N 


LelCutRangeFromList 


Cut element(s) from list 


N/A 




Undoc 


N 


LelDelnit 


Deinitialize list element object 


Lei - 


26 


Public 


N 
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LeIDestroy 


Oeinitialize list element object and free space 


Lei - 27 


Public 


N 


LeIGetCIient 


Return client 


Lei -28 


Public 


Y 


LeIGetDII 


Return list object 


Lei -29 


Fnend 


Y 


LeIGetNext 


Return next element 


Lel-30 


Friend 


Y 


LeIGetNthSuccessor 


Return Nth element 


Lei -31 


Friend 


N 


LeIGetPrev 


Return previous element 


Lei -32 


Friend 


Y 


Lellnit 


Is element in list 


Lei -33 


Public 


N 


LeIPasteRangeAfter 


Append e(ements(s) to list 


Lel-34 


Public 


N 


LeIPasteRangeBefore 


Insert elements) to list 


Lei -36 


Public 


N 


LelPasteRangeToUst 


Insert elements) to fist 


N/A 


Undoc 


N 


LeISendDestroy 


Send message for list element destruction 


Lei -38 


Public 


N 


LeITest 


Test for valid list element 


Lei -39 


Public 


N 


LeIVisitRange 


Visit function for range 


Lei -40 


Private 


N 



MclCreateGlass 


Create a class instance 


Mcl-2 


Private 


N 


McIDestroyCtass 


Destroy a class instance 


Mct-3 


Friend 


N 


MclFindSelector 


Find a selector index given its name 


Mcl-5 


Public 


N 


MclFindSuperdass 


find the superclass index given its name 


Mcl -6 


Public 


N 


MclGetClassName 


Get the class name 


Md-7 


Public 


N 


MclGetClassSize 


Return the size of a class instance 


Mcl-8 


Public 


N 


MclGetMessageCount 


Return the number of messages 


Mcl-9 


Public 


N 


MclGetNthMms 


Return the Nth MetaMessage 


Mcl-10 


Public 


N 


MclGetNthOffset 


Return the Nth Superclass offset 


Md-11 


Public 


N 


MclGetNthSuper 


Return the MetaClass 


Mcl-12 


Public 


N 


MclGetSuperClassCount 


Return the number of superclasses 


Mcl -13 


Public 


N 


MclPrint 


Print the MetaClass instance 


Mcl-14 


Public 


N 


MclSendCreateClass 


Return a new instance of the MetaClass 


Mcl - 15 


Public 


N 


MclSendDestroyClass 


Deallocate an instance of a Class 


Mcl-16 


Public 


N 


MclValidate 


Validate that the instance is valid 


Mcl -17 


Public 


N 


MclValidateMessages 


Validate the MetaMessages 


N/A 


Undoc 


N 


MclValidateSuperClasses 


Validate the MetaSuperClasses 


N/A 


Undoc 


N 



MemClear 


Clears array elements 


Mem 


-2 


Public 


N 


MemCopy 


Copy array elements within the array 


Mem 


•3 


Public 


N i 


MemCutNSet 


Delete elements, shift remaining 


Mem 


-5 


Public 


N i 


Mem Destroy 


Deallocate memory 


Mem 


•6 


Public 


N 


Mem Duplicate 


Copy array into another 


Mem 


-7 


Public 


N 


Mem New 


Allocate memory 


Mem 


■8 


Public 


N 


MemPasteNSet 


Expand array, shift remaining 


Mem 


•9 


Public 


N 


MemSetChr 


Set elements to character 


Mem 


•10 


Public 


N 
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MmsGetMethod 


Get the method 


Mms 


2 


Public 


N 


MmsGetSelector 


Get the name of selector 


Mms 


■6 


Public 


N 


MmsGetSuper 


Get name of superclass 


Mms 


■4 


Public 


N 


MmsPrint 


Display the instance 


Mms 


■7 


Public 


N 


MmsValidate 


Validate the instance 


Mms- 


•8 


Public 


N 



MscGetMetaClass 


Get the MetaClass 


Msc-3 


Public 


N 


MscGetName 


Get the name of superclass 


Msc-2 


Public 


N 


MscGetOffset 


Get offset of superclass 


Msc-4 


Public 


N 


MscPrint 


Display the contents of the MetaSuperCiass 


Msc-5 


Public 


N 


MscValidate 


Validate that the instance is valid 


Msc-6 


Public 


N 



MsgDelnit 


Deinit instance 


Msg 


-2 


Public 


N 


MsgGetMethod 


Return method 


Msg 


-4 


Public 


N 


MsgGetOffset 


Return the object offset 


Msg 


-3 


Public 


N 


MsgGetSelector 


Return selector 


Msg 


-5 


Public 


N 


Msglnit 


Initialize instanc 


Msg 


-6 


Public 


N 


MsgPrint 


Print the instance 


Msg 


-7 


Public 


N 


MsgSend 


Send message to object 


Msg 


-8 


Public 


N 


MsgSendReturnlnt 


Send message to object, return int 


Msg 


-9 


Public 


N 


MsgSendReturnPtr 


Send message to object, return pointer 


Msg 


-10 


Public 


N 


MsgSetSuperOffsetAndMethod 


Override the method 


N/A 




Undoc 


N 



ObjDelnit 


Deinitialize instance 


Obj 


•2 


Public 


N 


ObjDestroy 


Deinitialize and deallocate object 


Obj 


•3 


Public 


N 


ObjGetClient 


Return a client 


Obj 


•4 


Public 


N 


ObjGetClientOrNull 


Return client if non-NULL 


Obj 


■6 


Public 


N 


ObjGetCIs 


Return class 


Obj 


•8 


Public 


N 


ObjGetClsName 


Return class name 


Obj 


•9 


Public 


N 


ObjGetlmmediateClient 


Return immediate client 


Obj 


•10 


Public 


N 


ObjGetMethodAndOffset 


Return method and client offset 


Obj' 


11 


Public 


N 


ObjGetNthSuperObject 


Return nth superobject 


Obj- 


•13 


Public 


N 


ObjGetRootClient 


Get root client 


Obj- 


•14 


Public 


N 


ObjGetRootClientSize 


Get root object size 


Obj- 


•15 


Public 


N 


ObjGetSize 


Get object size 


Obj- 


•16 


Public 


N 


ObjGetSubObjectOffset 


Return offset to immediate subobject 


Obj- 


•17 


Public 


N 


Objlnit 


Initialize object 


Obj. 


•18 


Public 


N 


ObjlsRoot 


Return Treu if is root subobject 


Obj- 


•19 


Public 


N 


ObjRespondsToSelector 


Does object understand message? 


Obj- 


•20 


Public 


N 
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ObjSendMessage 


Send message to object 


Obj-21 


Public 


N 


ObjSendMessageReturnlnt 


Send message to object, return Int 


Obj-22 


Public 


N 


ObjSendMessageReturnPtr 


Send message to object, return pointer 


Obj-23 


Public 


N 



StrBasicExtract 


Extract a string 


N/A 


Undoc 


N 


StrExtract 


Extract siring as specified 


Str-2 


Public 


N 


StrFromDate 


Fill string with a date 


Str-4 


Public 


N 


StrFromMediumlnt 


Integer to string 


Str-6 


Public 


N 


Strlnit 


Init string to zero 


Str-8 


Public 


Y 


StrReplaceSubStr 


Replace sub-string in string 


Str-9 


Public 


N 


StrSet 


Copy string to another 


Str-11 


Public 


Y 


StrSqueeze 


Removes any character from string 


Str-13 


Public 


N 


StrToDate 


Parse a date string for year, month, day 


Str-15 


Public 


N 


StrToLower 


Change case of string to lower 


Str-17 


Public 


Y 


StrToMediumlnt 


String to integer 


Str-19 


Public 


N 


StrToUpper 


Change case of string to upper 


Str-21 


Public 


Y 



TreAsDH 


Return node as list 


Tre 


-2 


Private 


Y 


TreAsLel 


Return node as list element 


Tre 


-3 


Private 


Y 


TreAsObj 


Return node as object 


Tre 


-4 


Private 


Y 


TreClear 


Clear the tree 


Tre 


-5 


Public 


N 


TreClient 


Return client of node 


Tre 


-6 


Public 


Y 


TreClientFindChild 


Visit search function: children 


Tre 


-7 


Public 


N 


TreClientFirstChild 


Return first child node as client 


Tre 


-9 


Public 


Y 


TreClientLastChild 


Return last child node as client 


Tre 


-11 


Public 


Y 


TreClientLastLeaf 


Return last leaf node as client 


Tre 


-13 


Public 


Y 


TreClientNext 


Return next node as client 


Tre 


-15 


Public 


Y 


TreClientNextPreOrder 


Return next PreOrder client node 


Tre 


-17 


Public 


Y 


TreClientNextUncle 


Return next uncle as client 


Tre 


-19 


Public 


Y 


TreClientParent 


Return parent node 


Tre 


-21 


Public 


Y 


TreClientPrev 


Return prev client 


Tre 


-23 


Public 


Y 


TreClientPrevPreOrder 


Return previous client PreOrderly 


Tre 


-25 


Public 


Y 


TreCiientVisitBranchlnOrder 


Visit function: branch in-order 


Tre 


-27 


Public 


N 


TreClientVisitChildren 


Visit function: all children 


Tre 


-29 


Public 


N 


TreClientVlsitChildrenBwd 


Visit function: all children 


Tre 


-31 


Public 


N 


TreClientVisitDescBranchlnOrder 


Visit function: descendents 


Tre 


-33 


Public 


N 


TreClientVisitDesclnOrder 


Visit function: descendents 


Tre 


-35 


Public 


N 


TreClientVisitDesclnOrderBwd 


Visit function: descendents 


Tre 


-37 


Public 


N 


TreClientVisitDescLeaves 


Visit function: descendents 


Tre 


-39 


Private 


N 


TreClientvlsitDescPreOrder 


Visit function: descendents 


Tre 


-41 


Public 


N 


TreClientVisitlnOrder 


Visit function: in-order 


Tre 


-43 


Public 


N 


TreClientVisitlnOrderBwd 


Visit function: in-order 


Tre 


-45 


Public 


N 
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TreClientVisitLeaves 


Visit function: leaves 


Tre 


•47 


Public 


N 


TreClientVisitRarents 


Visit function: nearest parents first 


Tre 


-49 


Public 


N 


TfeClientVisitPreOrder 


Visit function: pre-order 


Tre 


•51 


Public 


N 


TreClientVisitRange 


Visit function: range 


Tre 


•53 


Public 


N 


TreClientVisitSuccPreOrder 


Visit function: all successors 


Tre 


-55 


Public 


N 


TreClientVisitSuccessors 


Visit function: successors 


Tre 


•57 


Public 


N 


TreCutChildren 


Cut children from tree 


Tre 


■59 


Public 


Y 


TreCutRange 


Cut node(s) from tree 


Tre 


•61 


Public 


Y 


TreDelnit 


Deinitialize Tree object 


Tre 


-63 


Public 


N 


TreDestroy 


Deinitialize Tree object and free space 


Tre 


-64 


Public 


N 


TreDestroyChildren 


Destroy any children of a tre 


Tre 


•65 


Public 


N 


TreRrstChild 


Return first child 


Tre 


•66 


Private 


Y 


TreHasChildren 


Does node have any children 


Tre 


•68 


Public 


Y 


TreHasSiblings 


Does node have any siblings 


Tre 


■69 


Public 


Y 


Trelnit 


Initialize tree object 


Tre- 


■70 


Public 


N 


TrelsChild 


Does the node have a parent 


Tre 


•71 


Public 


Y 


TrelsDirectAncestor 


Is node a direct ancester 


Tre- 


■72 


Public 


N 


TrelsRoot 


Does the node have no parent 


Tre- 


•73 


Public 


Y 


TreLastChild 


Return last child 


Tre- 


■74 


Private 


Y 


TreLastLeaf 


Return last leaf 


Tre- 


•76 


Private 


N 


TreNext 


Return next node 


Tre- 


•78 


Private 


Y 


TreNextPreOrder 


Return next node PreOrderty 


Tre- 


•80 


Private 


N 


TreNextUncle 


Return next uncle 


Tre 


•82 


Private 


N 


TreParent 


Return parent node 


Tre 


•84 


Private 


Y 


TrePasteRangeAfterSibling 


Paste range of siblings 


Tre 


•86 


Public 


Y 


TrePasteRangeBeforeSibiing 


Paste range of siblings 


Tre 


■88 


Public 


Y 


TrePasteRangeRrstChild 


Paste children 


Tre 


■90 


Public 


Y 


TrePasteRangeLastChild 


Paste children 


Tre 


•92 


Public 


Y 


TrePrev 


Return previous node 


Tre- 


•94 


Private 


Y 


TrePrevPreOrder 


Return previous node PreOrderty 


Tre- 


96 


Private 


N 


TreSendDestroy 


Send message for tree destruction 


Tre- 


98 


Public 


N 


TreVisitBranchlnOrder 


Visit function: branch in-order 


Tre- 


•99 


Private 


N 


TreVisitChildren 


Visit function: children 


Tre- 


•101 


Private 


N 


TreVisitChildrenBwd 


Visit function: children 


Tre 


•103 


Private 


N 


TreVisitDescBranchlnOrder 


Visit function: descendents 


Tre- 


105 


Private 


N 


IPC* lOimCOvll Ivl UCI 




Trp ■ 


107 


PrivatP 


N 


TreVisitDesclnOrderBwd 


Visit function: descendents 


Tre- 


109 


Private 


N 


TreVisitDescPreOrder 


Visit function: descendents 


Tre- 


111 


Private 


N 


TreVisitlnOrder 


Visit function: in-order 


Tre- 


113 


Private 


N 


TreVisitlnOnderBwd 


Visit function: in-order 


Tre- 


115 


Private 


N 


TreVisitLeaves 


Visit function: leaves 


Tre- 


•117 


Private 


N 


TreVisitParents 


Visit function: nearest parents first 


Tre- 


119 


Private 


N 


TreVisitPreOrder 


Visit function: pre-order 


Tre- 


121 


Private 


N 


TreVisitRange 


Visit function: range 


Tre- 


123 


Private 


N 


TreVisitSuccPreOrder 


Visit function: all successors 


Tre- 


125 


Private 


N 


TreVisitSuccessors 


Visit function: successors 


Tre- 


127 


Private 


N 
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■ aye 


Scope Macro 


i sKDdSic Assen 


rounuduon tuncuon 


Iwn 


• 

Undoc 


N 


1 SKuonoiuon 


ndise exception conuiuoneuiy 




Public 


N 


i swjuimi 


UclHIUrilULc If Iblairuc 


1 oft " *r 


Public 


N 


I skuetauitinit 


initialize instance witn defaults 


ISK - 0 


Public 


N 


isktxit 


Exit program with code 


ISK - 0 


Public 


N 


1 SKcXIlWIulMSg ' 


txii program ana pnni message 


Telr - 7 
1 5K * / 


Public 


N 


i SKuetArgc 


bet mainy argumeni count 


ISK - 0 


Public 


N 


I sKCaetArgv 


bet mainy argument vector 


TeU O 

iSK-y 


Public 


N 


TskGetExceptionCondition 


Return exception condition 


ISK - 10 


Public 


N 


i sKbettxcepuonriieNanie 


Dciti ir»s filnnimA aI AWAAn4iAft 

netum niename or exception 


I SK - 11 


Public 


N 


i skGetcxceptionuneNo 


Return exception line number 


ISK - 1Z 


Public 


N 


I sKbethxception i ype 


Ketum exception type 


ISK * 10 


Public 


N 


1 SKinll 


fr%Jft**f i^/^ SnAtAAAA 

initialize instance 


Tel' 1C 
I SK - ID 


Public 


N 


i skisinitiaiizea 


istne i ask initialized 


M/A 


Undoc 


N 


i sKLoguona 


Kaise exception conoiaonaiiy 


I SK - 1 / 


Public 


N 


T**L/fc J^Inl s\s*^^f> ryrl 

1 SKMEinLOyLrOnu 


naise exception conof uonaiiy 


Tek 10 
ISK - iy 


Public 


N 


I SKMdinrreOOnO 


Kaise exception conditionally 


Tek 01 
ISK - c 1 


Public 


N 


isKMainrtrcona 


Kaise exception conditionally 


ISK - ^0 


rUOHC 


IN 


TskMainRaiseException 


Raise exception unconditionally 


Tsk-25 


Public 


N 


TskNormalExit 


Exit task normally 


Tsk-27 


Public 


N 


TskOnException 


Establish exception handler 


Tsk-28 


Public 


N 


TskPopExceptionHandler 


Pop exception handler 


Tsk-30 


Public 


N 


TskPreCond 


Raise exception conditionally 


Tsk-32 


Public 


N 


TskPrintException 


Print description of exception 


Tsk-34 


Public 


N 


TskPropagateException 


Pass last exception 


Tsk-36 


Public 


N 


TskPtrCond 


Raise exception conditionally 


Tsk-38 


Public 


N 


TskPushExh 


Push the exception 


N/A 


Undoc 


N 


TskRaiseException 


Raise exception unconditionally 


Tsk-40 


Public 


N 



VtxAsGrfLel 


Return list element in graph 


Vtx- 


2 


Friend 


Y 


VtxAslnDII 


Return vertex as list of incoming edges 


Vtx 


■3 


Friend 


N 


VtxAsObj 


Return edge as object 


Vtx- 


4 


Private 


N 


VtxAsOutDII 


Return vertex as list of outgoing edges 


Vtx- 


•5 


Friend 


N 


VtxClear 


Clear vertex 


Vtx- 


6 


Public 


N 


VtxConneclToGrf 


Connect vertex to graph 


Vtx- 


7 


Public 


N 


VtxCountln 


Count incoming edges 


Vtx- 


■9 


Public 


Y 


VtxCountOut 


Count outgoing edges 


Vtx- 


11 


Public 


Y 


VtxDelnit 


reinitialize the Vertex object 


Vtx 


•13 


Public 


N 


VlxDestroy 


Deinitialize Vertex object and free space 


Vtx 


■14 


Public 


N 


VtxDisconnectFromGrf 


Disconnect vertex from graph 


Vtx- 


15 


Public 


Y 


VtxRndOutEdg 


Visit search function: outgoing edges 


Vtx 


•17 


Private 


N 


VtxRndOulEdgaient 


Visit search function: outgoing edges 


Vtx 


•19 


Public 


N 


VtxGetClient 


Return client of vertex 


Vtx- 


21 


Public 


Y 
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VtxGetFirstln 

VtxGetFirstOut 

VtxGetGrf 

VtxInGrf 

Vtxlnit 

VtxSendOestroy 

VtxStackSetup 

VtxVisitEdge 

VtxVisitEdgeClient 

VtxVisitlnEdge 

VlxVisitlnEdgeClient 

VtxVisitOutEdge 

VlxVisilOutEdgeaient 



Return first incoming edge 
Return first outgoing edge 
Return graph 
Is vertex in graph 
Initialize the Vertex object 
Send message lor vertex destruction 
Set up values for topsort 
Visit function: each edge 
Visit function: each edge 
Visit function: incoming edge 
Visit function: incoming edge 
Visit function: outgoing edge 
Visit function: outgoing edge 



Vtx-22 
Vtx-23 
Vtx-24 
Vfx-26 
Vtx-25 
Vtx-27 
Vtx-28 
Vtx-29 
Vtx-31 
Vtx-33 
Vtx-35 
Vtx-37 
Vtx-39 



Public 
Public 
Friend 
Public 
Public 
Public 
Friend 
Friend 
Public 
Friend 
Public 
Friend 
Public 



Y 
Y 
Y 
Y 
N 
N 
Y 
N 
N 
N 
N 
N 
N 
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C+0 Datatypes 



Name 


Size 


Definition 


Usage 


Blk 


20/38 


struct B/ocfc 


fl/ocfc class 


Block 


20/38 


struct Bfocfc 


B/ocfr class 


Bool 


1 


char 


Boolean values: True or False 


Call 


N/A 


(Void) 


Overrides function returning value 


Char 


1 


char 


Text data 


Chr 


1 


char 


Text data 


Class 


16/26 


struct C/ass 


Class class 


ClientPtr 


2/4 


Void * 


Data pointer to unknown type 


CIs 


16/26 


struct C/ass 


Class class 


Const 


N/A 


const 


Identifies function oarameters which are not modified 

1WVI lUHVW IUI IVUVI 1 Mill VU ■ ■ \f iv # W IflWVH Ul v > ivl IIIVUIIIWU 


DateFormat 


2 


enum DateFormat 


Describe a display format for dates (see JulianTime and 








Strindl 


Dll 


6/12 


struct L/sf 


Ust class 


Dpa 


8/10 


struct DynamicArray 


DynamicArray dass 


DynamicArray 


8/10 


struct DynamicArray 


DynamicArray class 


Edg 


26/52 


struct Edge 


Edge class 


Edge 


26/52 


struct Edge 


Edge class 


ExceptionType 


2 


enum ExceptionType 


Type of exception generated (see Tas/c) 


ExcRlter 


2/4 


Bool (*)( PTSK ) 


Function pointer to exception filters (see Task) 


Ext 


2 


enum ExceptionType 


Type of exception generated 


False 


N/A 


((Bool)0) 

Wit 


Boolean False 


Flags8 


1 


unsigned char 


Bit flags (8) 


Flags16 


2 


unsigned short 


Bit flags 16) 


Rags32 


4 


unsigned char 


Bit flags (32) 


uenencrir 




VOlu 


uata pointer to unwiown type 


Grap/? 


30/48 


struct Graph 


Graph dass 


Grf 


30/48 


struct Graph 


Grapft class 


IntAddress 


2/4 


int/long 


Integer capable of holding a data address 


Jul 


4 


struct JulianTtme 


Ju//an77/nedass 


JulianTtme 


4 


struct JulianTime 


Ju//an77/nedass 


LARGE DATA PTRS 


N/A 


N/A 


Defined if 4 byte data pointers are the default 


LARGE_FUNC_PTRS 


N/A 


N/A 


Defined if 4 byte function pointers are the default 


Largelnt 


4 


long 


Integers in the range [-2147483647:2147483647] 


Lei 


8/16 


struct UstElement 


UstElement class 


LINEJJO 


N/A 


_LINE_ 


Line number in file being compiled 


Ust 


6/12 


struct L/s/ 


Ust class 


UstElement 


8/16 


struct UstElement 


L/sfE/emenfdass 


Mcl 


20/30 


struct MetaClass 


MetaClass dass 


Mediumlnt 


2 


int 


Integers in range [-32767:32767] 
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C+0 Datatypes 



Name 


Size 


Definition 


Usage 


IVICI 1 1 


1 i 


char 

vi IQI 


Memory class 


KAamnrv 
mClllwl y 


1 


char 

wl lul 


Memory class 


nftcooayu 


12/22 


struct Messaae 

OlIUwl irlbWWM^V 


Messaoe class 




20/20 


struct MetaClass 


MetaClass class 


kAatcthAaccsMP 
Mulawttobayu 


W l*t 


struct A/fPto/Lfpcsanp 

OUUUl iVICiafVIUOOayU 


MetaMessaae class 


Mate Si inprCto ce 


12/22 


struct MetaSuoerClass 

Oil Uwl IrlwlClwWjU'w* Vfuvu 


MetaSuoerClass class 


MothnH 


OIL 


Void f*V POBJ I 


Function Dointer fses Blocks 

1 Ul iwUwl l pvilllwl |wvC u/iwwrvy 


MothnriRotRnnl 


OIL 


Ron! f*V PORJ } 


Functinn frptuminn Rcol\ nointpr /see Blocks 

1 Ul IwUwl 1 ^IwlUllllll^ UUVIJ |kA/ll llwl |«vv wivun^ 


MothnH Rotlnt 

IVlcS liiUU nc III u 


OIL 


Medium lnt/*W POBJ \ 


Function /retuminn Medium Int) Dointer (see Block) 

1 U1 IvUvl 1 ll WlUII HI IU IIIvUIUI 1 1 II 141 WV" Uwl IWWW WWW'W 


MothriHRotriataPtr 


OIL 




Function /retuminG data Dointer} Dointer /see Block\ 

1 Ul Iwllwl 1 1 1 w *Ul 1 ill Im UQIQ wVill Uwl / Mvii llwl ^ Jvv uiwvn^ 


MeinoGneiruncru 


OIL 


PMTH /*\/ POR 1 \ 


Ftmrtinn /rptiiminn function nointpr\ nointer /see Block) 

1 UIIUUUII llwlUllllll^ IUIIUUUII pwll llwl j pull Uwl 


MnthnHDotPtr 

Meinoarieirir 


OIL 


%/ntrt * POR 1 t 


Funrtion /refurninn nointph nointpr /spp Block) 

ruiiuuuii \iwiuiiiiny |Ajiniciy pun iiwi \Occ uiuuny 


Mms 


0714 


SuUCi MeiaMcSSayc 


KAotokAoccof^o rJacc 
MclaMuoSayc ukloo 




IM/A 


Fll F 


Namp of file beina comoiled 

iiaiiiw ui iiiw Uvii iy wumpiiwu 


Me/* 
MSG 


19/92 

\ CJ cc 


ctn irt A/fpfc?^//npf^feee 


MptaStinprClass class 


Men 


\0I00 
\ cjcc 


ctn irt JLfpccoflp 
ouuui tvicooayc 


Messaae class 


KM II 1 
NULL 


OIL 

4/4 


n 

U 


1 lepH to accinn or rptum null nointPrs 

uocu lu aooK^ii WI ICIUMI t lull puiiiicio 


UDJ 


OIL 


oUuUl yjUjcitl 


Oh/pr/rloee 
K/UJUM uiaoo 


UUJcCl 


9/4. 


ctn irt flhfart 


Ohipct class 

vU/Pvi wiaoo 


DPI W 


9/4. 


ctn irt Rfnrk * 

OUUUl O/UUn 


Rtnrk nointpr - dnps not rpouire structure definition 

U/UvA LA/M Uwl WUwO 1 IUI IwUjUllw OUUwlUlw UwlllllUVII 


rulU 


9/4 


ctn irt ftnncrtlplnni itOi itra it * 

OUUUl U/Ul IOUMCMI ipUlU/UlfJUl 


fionsolelnnutOutnui oointer - does not reouire structure 

VVl lOUIwll lUUlWUipUl J^UII llwl WGO llwl IWVfUUw OllliWIUIw 








Hpfinitinn 

UwlllUUUH 


DPI Q 


9/4. 
<£/4 


ctn i/*t P/ncc * 


/"7a cc nointpr - Hops not rpouirp structurp dpfinition 

K/taOO Uvllllwl UUCO 1 lul ICVfUllw OUUUlUlv UCIIillUUII 


PHI 1 


9/4. 


ctn irt / / cf * 


/ /c/oointpr - does not reouire structure definition 

Uw( UUII llwl UUwO 1 IUI 1 wUUII w OUUwlUlw wwliMiuvi 1 


rurM 


OIL 


ctn irt Hx/nam i/* Array * 


DvnamicArrav oointer - does not reouire structure 

\J jl fCHf/lw/u 1 Of k/wM llwl Uwww IIWI 1 v^Ullw wUUwlUiw 








dpfinition 

UwlllllUUII 


PFnn 

ruUvj 


OIL 


struct Fdne * 

Oil Uwl bUV|v 


Edae oointer - does not reauire structure definition 


runr 


OIL 


struct Gfaoh * 


Graoh Dointer - does not reauire structure definition 


P 11 11 

"JUL 


OIL 


struct JulianTiiriP * 

Oil Uwl vUltOU f f f/liw 


JulianTime oointer - does not reouire structure definition 
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Pt Fl 


2/4 


struct ListElement * 

oil uwi iJw(Uw>nvi it 


UstElement pointer - does not require structure definition 


PMfM 

r IViV/L 


OIL 


struct A/fpfaCfess* 

OUUwl frlWiCIw'fGOO 


MetaClass pointer - does not require structure definition 


PMFM 


OIL 


Char* 

vl IQI 


Mem oointer - does not reouire structure definition 

• Tlwlll MVH llwl VIVV4 1 IVI IWVtW'IW WU WWIWI W WWIH IIUWM 


PMM<5 

r IVIIVIO 


OIL 

CJ*T 


struct MpfeiWpssaflp * 

Oil Uwl fvfwiai rlCOOviyw 


MetaMessaoe oointer - does not reauire structure definition 
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PM^P 


OIL 

CJH 


stmct MpfaSiinprOfass* 

ouuwi wtuiayjUfJGi wiaoo 


MetaSuoerClass oointer • does not reauire structure 
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definition 

WW III II Uwl 1 


PMSG 


2/4 


stnjct Message 1 ' 


Message pointer - does not require structure definition 


PMTH 


2/4 


Void (*)( POBJ, ... ) 


Function pointer (see 8/octf) 


POBJ 


2/4 


struct Ofcyecf* 


Object pointer - does not require structure definition. Also 








synonymous with a class pointer of unknown type 


PSTR 


2/4 


char* 


Null terminated text strings 


PTRE 


2/4 


struct Tree * 


Tree pointer - does not require structure definition 


PTSK 


2/4 


struct Task" 


Task pointer - does not require structure definition 


PVTX 


2/4 


struct Vertex * 


Vertex pointer - does not require structure definition 


Real 


8 


double ~ 


Floating point (no range specified) 


Reg1 


N/A 


register 


Prioritized register allocation 
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Name 


Size 


Definition 


Usage 


Reg2 


N/A 


register 


Prioritized register allocation 


Reg3 


N/A 


register 


Prioritized register allocation 


Reg4 


N/A 


register 


Prioritized register allocation 


Reg5 


N/A 


register 


Prioritized register allocation 


Smalllnt 


1 


char 


Integers in range [-127:+127] 


Str 


1 


char 


Text data 


String 


1 


char 


Text data 


Task 


24/32 


struct Task 


Task class 


Tre 


16/32 


struct Tree 


Tree class 


Tree 


16/32 


struct Tree 


Tree class 


True 


N/A 


((Bool)1) 


Boolean True 


Tsk 


24/32 


struct 7as/c 


Task class 


1 11 arnplnt 




ui loiyi icu I vi iy 


mi icy ci o in uic laiiyc [u.UArrrrri rrj 


UMediumlnt 


2 


unsigned int 


Integers in the range [OrOxFFFF] 


USmalllnt 


1 


unsigned char 


Integers in range [OrOxFF] 


Vertex 


22/44 


struct Vertex 


Vertex class 


Void 


N/A 


void 


Function declarations 


Volatile 


N/A 


volatile 


(default) Identifies function parameters which are modified 


Vtx 


22/44 


struct Vertex 


Vertex class 
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Getting Started 



This section explains how to get C+O class libraries installed, what the 
directory structure looks like, source code organization, library organization 
and most important, organization of the C+O Documentation Set. 

Instal lin g C+O class libraries is easy and you will be up in running quickly. 
However, hold back on the temptation of jumping to the install subheading, 
you're almost there! Once you have installed C+O, take a few minutes to 
familiarize yourself with the directory organization of C+O, you will probably 
want to view certain files as you're reading through the rest of the 
documentation. Also spend a few minutes thumbing through the manual. Get 
comfortable with its organization before you begin reading it in depth. 



Manual Organization 

C+O is divided into two books, the User's Guide and the Reference Manual. 
This is the User's Guide. The Reference Guide, is a concise description of all 
the functions supported by C+O. 

The diagram at the front of this manual, Class Inheritance Diagram, gives a 
picture of how C+O classes inherit behavior (this will make sense once you've 
read the rest of the User's Guide). 

The table, C+O Datatypes, lists all the #defines and typedefs used by C+O. 
Refer back to this table whenever you encounter a keyword or datatype name 
you are not familiar with while looking at C+O code or reading this manual. 

The table, Quick Reference: Class Functions, gives an alphabetical listing of all 
the functions in this library and a short description. This is handy as a fast 
way of locating a function. 

The User's Guide should be read first. This section you are reading now will 
help you install G+O and figure out where to look for other information. 

Section Two of the User's Guide, Writing a C+O Program, gives you a quick start 
on writing a program using C+O class libraries. You might want to read this 
section quickly to get an overview, read section Three, then come back to 
section Two. 

Section Three of the User's Guide, The Object-Oriented Approach to Developing 
Software, describes the concepts, methods, and techniques you will need to 
understand before writing substantial applications using C+O. Once you have 
read through this, we recommend that you examine the example source code 
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provided with C+O. The last subsection in this section, Test-Driving Classes, 
will tell you where to find that code and how to compile and link it. 

The Class Siunmary is the place to find out what a class is used for, how it is 
implemented, what functions are available, and what other classes may be 
related. Spend some time reading through this section, this is where to go 
when you are looking for a particular class. 

Appendix A, Class Exceptions Reference, is a complete listing of all the 
exceptions which can be generated by C+O. It is organized by function name. 
Within each function it lists the file name and line number where the exception 
was detected along with a message describing what the exception means. The 
file name and line number is what will be displayed on your screen when 
running a C+O program and an exception is detected and trapped by an 
exception handler. You will refer to this section often as you begin writing your 
first C+O program. 

Once you have made it through the User's Guide, you will be ready to go 
through the Reference Manual. The Reference Manual consists of the Class 
Inheritance Diagram, the Quick Reference, the C+O Datatypes Table, and the 
Class Reference. The first three items are the same as described for the User's 
Guide. 

The Class Reference is where to go to find out the details of a particular 
function. Each function occupies a minimum of one page and often two. 
Where useful, diagrams or examples are provided. This section is arranged 
alphabetically by nmction name. 



installing C+O Class Libraries 

To install C+O you should have 2.0 Megabytes of hard disk storage available. 
If you have the source code option, you will need a total of 3.0 Megabytes. 

While it is possible to install C+O class libraries on a floppy disk f it is not 
recommended. We cannot recommend a floppy disk organization that will work 
for everyone so if you are intent on installing this on a floppy system, you will 
have to manually copy files over to your working disks. The install procedure 
provided assumes that all files can be copied onto a single disk. 

To install C+O on your hard disk system, change your current drive to A and 
type INSTALL followed by the fully qualified path you wish to install under. We 
recommend installing it to the directory COBJECTS. 



C:> A: 

A:> INSTALL C:\COBJECTS 



Installing C+O on a Hard Disk 
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C+O will create the necessary directories and copy its files, prompting you to 
change disks when appropriate. You may abort the install at any time and 
restart it if need be. C+O is not copy protected and will not put any hidden 
files on your disk. 

For convenience in referring to the install directory, we assume you have 
installed C+O to C:\COBJECTS. If you installed to another disk or directory, 
just substitute the name you installed to wherever we mention C:\COBJECTS. 

INSTALL creates four subdirectories under C:\COBJECTS. These directories 
are: 



LIB Microsoft Library files (.LIB extension) containing C+O object code for 

different memory models and debug and production executables. 

INC C+O include files (.H extension) used for compiling C+O programs. 

TST C source files (.C extension) which can be compiled to test C+O 

functions and demonstrate how to use C+O classes. Also includes link 
files (.LNK extension) and batch files (.BAT extension) for compiling and 
linking. 

SRC C source files (.C extension) which implement the C+O classes. This 

directory is created only if you have purchased the source code option. 
Also includes batch files (.BAT extension) for compiling C+O libraries. 



Directory structure of C:\COBJECTS 



Source Code Organization 

The source code provided with C+O consists entirely of C code, namely .C and 
.H files. C+O source code is divided into classes. Each class has a long name 
and a three letter abbreviation. The abbreviation, or prefix is used in naming 
functions, naming variables, and naming the source code files. C+O source 
code has the following naming convention and associated meanings. The table 
shown uses a hypothetical class with the prefix Xyz. 
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xyz.h This file holds the structure declaration for the class whose abbreviation 
is Xyz. This file is included if you need the structure definition of Xyz. 

xyzmach This file holds the function declarations and macros for the class Xyz. 

This file is included if you need to perform functions against an object of 
class Xyz. It automatically includes xyz.h. 

xyzcls.h This file holds any function declarations and macros which are private to 
the class. It also holds the MetaClass definition of the class if it has one. 
This file is included only by the C file which defines the class Xyz 
functions (xyz.c). 

xyz.c This file holds the function definitions for Xyz. Each function in this file is 

prefixed with Xyz and takes a pointer to Xyz as its first parameter. These 
files are included only if you have purchased the source code option. 



C+O Source Code Organization 

Library Organization 

C+O comes with precompiled object code organized into object libraries. 
Libraries are provided for several different memory models, including small, 
medium, large and compact. 

Libraries are also provided for creating debugging and production executables. 
This allows you to test your code with the larger, slower debug libraries which 
will help you catch many bugs before they cause a problem. Then when you 
are ready to create a so-called production executable, you can link with the 
production libraries which are much faster and smaller, with all the debugging 
code removed. The following list describes each library provided. 



cobjds.lib Small memory model. Debug version, 

cobjdm.lib Medium memory model. Debug version. 

cobjdMib Large memory model. Debug version, 

cobjdc.lib Compact memory model. Debug version, 

cobjps.lib Small memory model. Production version, 

cobjpm.lib Medium memory model. Production version, 

cobjpl.lib Large memory model. Production version, 

cobjpc.lib Compact memory model. Production version. 



Libraries supplied with C+O 
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Test-Driving Classes 

C+O comes with a set of demo programs which allow you to test C+O classes in 
a controlled environment. You may want to study this code to understand 
better how to use C+O class libraries. 

To run the test programs you must first compile and link them. Batch file 
procedures exist in the C:\COBJECTS\TST directory for compiling and linking 
all the test programs. Each test program uses one or more classes. The 
following table identifies the test programs provided and what they do. 



1_1U 11., 

tstblk.c 


Demonstrates the Block class. 


tstcls.c 


Demonstrates the Class class and to a lesser degree Object class. 


tstdll.c 


Demonstrates the List class. Should also see tstlel.c which 
demonstrates ListElements. 


tstdpa.c 


Demonstrates the DynamicArray class. Also shows example of abstract 
superclass and message sending. 


tstgrf.c 


Demonstrates the Graph, Vertex and Edge Classes. Also provides a 
simple example of how an Adventure game might be set up using these 
classes. " ' 1 


tstjul.c 


Demonstrates the JulianTime class. 


tstlel.c 


Demonstrates the ListElement class. Should also see tstdll.c which 
demonstrates the List class. 


tstmcl.c 


Demonstrates the MetaClass and to a lesser degree, the MetaMessage 
and MetaSuperClass classes. 


tstobj.c 


Demonstrates the Object class. 


tststr.c 


Demonstrates the String class. 


tsttre.c 


Demonstrates the Tree class. 


tsttskx 


Demonstrates the Task Class (mainly exception handlers.) Also see 
tsttskl .c, tsttsk2.c, and tsttsk3.c 



Demonstration and Example Source Code 
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In this section, you will learn how to write, compile, and link a C+O program. 
Before beginning, it is recommended that you have already read section Three, 
The Object-Oriented Approach to Developing Software. This section is printed 
first for those who can't wait to dive in! 



Anatomy of a C+O Program 

In this section we will take you through the steps needed to compile and link a 
program using C+O classes. 

Let's start by creating the shell of a C+O program. The main thing we want to 
show here is that all C+O programs need to set up at least one exception 
handler near the beginning of the program. The reason for this is that C+O 
may detect a bug while running. Rather than try and handle it locally, it 
jumps back up to the exception handler which typically prints the exception 
information and then exits the program (after some cleanup we assume). 
Thus, even a buggy program can be well-behaved. In general all C+O programs 
need to be set up in this fashion. Example 1 shows the mainfj function for a 
C+O program. 



#include "cobiects.h" 
#ifndef TSK 
#include "tskmac.h" 
#endif 

static PSTR ModuleName = MODULE_NAME; 

int main( int argc, char "argv ) 

TskDefaultlnit( TskMain, argc, argv ); 

if ( TskOnException( TskMain ) ) { 
TskPrintException( TskMain ); 
return TskExit( TskMain, 1 ); 



I* Application logic goes here... */ 
TskNormalExit( TskMain ); 



Example 1 - Typical mainO function for C+O program 
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All C+O programs need to include the header file "cobjects.h". This file defines 
many typedefs used by C+O classes. These typedefs nelp make C+O libraries 
more portable than they otherwise would be. C+O libraries do not use any of 
the built-in types provided by C directly. All fundamental datatypes used by 
C+O are defined as typedefs in this file. For example, Smalllnt, Mediumlnt, 
and Largelnt are int typedefs for 8 bit, 16 bit, and 32 bit quantities 
respectively. String is a char, and PSTR a pointer to char. The table at the 
beginning of this manual, C+O Datatypes Table, explains the different 
datatypes and keywords defined by C+O. 

Next let's look at the code fragment immediately following the inclusion of 
cobjects.h. This code fragment is how we include an H file in C+O programs. 



#ifndef TSK 
#include "tskmac.h 
#endif 



Example la - Conditional inclusion of an H file 

Each class header file defines a macro when the file is included. Because C+O 
headers also include class headers for other classes, we would like to make 
sure we only read in those files once. Hence, we always conditionally include 
files based on a macro being undefined. The following table shows what 
naming convention is used for various H files: • 



xyz.h XYZ JH 
xyzmac.h XYZ 
xyzcls.h XYZCLS 



Table lb - Conditional include variables 

Moving back to our original Example 1, we have included tskmac.h. This file 
will automatically include tsk.h. We include this file because we will be calling 
Task functions. In general, whenever we want to access one or more functions 
that belong to a class, we must include the xxxmac.h header for that class 
(where xxx is the class prefix). 

Next we define the static variable ModuleName. This variable is referenced by 
assertion macros. MODULE_NAME is the name of the C file being compiled. 



static PSTR ModuleName = MODULE_NAME; 
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Assertion macros are used to check the logic of programs. If the condition 
specified in an assertion fails, an exception is generated and generally a 
message displaying the filename and line number where the exception was 
generated appears. We will get back to exception handlers in a minute. By 
using a variable instead of a string literal (as Microsoft's implementation of 
assert does), we do not repeatedly store the same string in the constant data 
segment of our executable. This can be a significant chunk of memory when 
you use lots of assertions as C+O does. 

Next, after the declaration of mainO, we want to initialize a Task object. The 
Task class automatically declares a global Task instance called TskMain. 



TskDefaultlnit( TskMain, argc, argv ); 



Example Id - Initializing TskMaln 

The Task class is used to model the C+O program itself. There is typically only 
one instance of a Task in a running program. This would be TskMain. 

The Task class is important to all C+O programs because it defines the 
exception handling mechanisms. C+O relies heavily on exception handlers to 
signal problems in using C+O libraries. C+O is very good at detecting invalid 
pointers, memory corruptions, and uninitialized data. 

Once a Task has been initialized (preferably TskMain), we can set up an 
exception handler. 



if ( TskOn Exception ( TskMain ) ) { 
TskPrintException( TskMain ); 
return TskExit( TskMain, 1 ); 



Example le - Setting up an exception handler 

An exception handler is set up by calling TskOnException. The return value 
from TskOnException is 0 when the handler is set. However, if an exception is 
raised, even if it is several layers of function calls below main, then control is 
transferred to the statements inside the if statement. It is then up to these 
statements (the exception handler) to determine how to process the error. 
TskOnException behaves very much like the Ansi C function setjmpO and in 
fact is implemented using setjmpO. 
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The particular exception handler shown here will print a message displaying 
the filename and line number where the exception was detected and then exit 
the program. 

Finally, the statements following the exception handler are the statement which 
make up your program. When the program is ready to exit it should call 
TskNormalExitO. Please take a look at the Task Class Summary for a more 
complete discussion of the functions discussed here and others which will be of 
interest. Also, be sure and look at the example Task code provided. It 
demonstrates exactly how exception handlers behave under a variety of 
circumstances- 
Creating a Class of Your Own 

To use some C+O classes, you must build a new class on top of an existing 
one. These classes include: ListElement, List, Tree, Vertex, Edge and Graph. 
For more information on how to do this, read section Three, The Object- 
Oriented Approach to Developing Software, and also study the related example 
code. 

Other classes, specifically JulianTime, String, DynamicArray, and Memory are 
usable as is without prior setup. However, the principles or encapsulation still 
apply and you may wish to create a class which incorporates one or more of 
these classes. 

Finally, several classes exist for supporting the object-oriented functionality of 
C+O classes and for supporting exception handling. These classes include: 
MetaClass, MetaMesage, MetaSuperClass, Class, Object, Message, Block, and 
Task. You will be using some functions from almost every one of these classes 
in building a C+O program so it is important you understand their role and 
usage. It is doubtful you will want to extend these classes, but should you 
wish to, please try and keep your extensions upwardly compatible — after all, 
these classes provide the foundation for object-oriented programming in all 
C+O class libraries. 

For examples of using classes, please refer to the example code provided. A 
separate program is provided for most classes. 

Because many C+O functions are macros, you should avoid calling functions 
with parameters which have side effects such as the pre or post increment 
operators. 

Debug and Production Libraries 

C+O provides two kinds of libraries, debug and production. The major 
difference between them is that the debug library includes lots of argument 
checking whereas the production library does not. Another difference is that 
the production Libraries use C+O macros and the debug libraries use the 
function equivalent. 
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When you are first testing a program that uses C+O classes you will want to 
compile and link it with ±e debug libraries so as to catch any error of use. 
When you have debugged your program, you can recompile it for the 
production libraries and the resulting executable will be much smaller and 
much raster. 

You must always compile your code appropriately for the particular C+O 
library you intend to link with. This means you must choose an appropriate 
memory model and you must define the COBJPRD flag (preferably with 
compiler startup flags) if you are going to link with the production libraries, 
btructure sizes are different for debug and production versions so it is 
imperative that you not mix these two styles. 

Compiling 

Compiling a C+O program is the same as compiling any other. You mav use 
Stag?** C ° mP switches you want but y° u must be awar e of the following 

?* C+0 !f braries are compiled without packing structure members (/Zp 
option). Compiling your code with this option will cause problems. 

C+O class libraries are compiled for the alternate floating point math package. 

You must define the identifier COBJPRD when you wish to produce your final 
So^o C Ji° n ^utable. If you are intending to link with a debug libranr, do not 
define this switch. In either case, your entire program must be compiled with 

W mn f d b g ^ foUowing shows a compfie line for 



C:>CL /D COBJ_PRD /AL /W3 /Ox /Fpa 10 1\ C:\COBJECTS\INC XYZ.C 



How to Compile for Production Code, Large Model 
p^odSctiSS 3111 ^ 6 Sh ° WS Same C ° mpile ^ but 0me g enera tes 



C:>CL /AL /W3 /Ox /Fpa /C /I C:\COBJECTS\INC XYZ.C 



How to Compile for Debug Code, Large Model 

? eed , C+0 paries compiled with other options, memory models, or 
floating point packages, please contact Objective Systems. We can provide you 
with these libraries at little or no cost. y 
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Linking 

You may link C+O programs with the standard linker provided by Microsoft. If 
you have compiled your code with the preprocessor variable COBJJPRD, you 
must link with the production libraries (COBJPx.LIB where x is the memory 
model letter). Otherwise link with the production libraries (COBJDx.UB). The 
following example shows how to link a C+O program compiled for debug and 
the large memory model. 



C:>LINK XYZ,XYZ,XYZ,\COBJECTS\UB\COBJDL \MSC\LIB\LLIBCE; 



Debugging 

You may use whatever debugger you are using now to debug C+O programs. 
Codeview is our preference. C+O libraries are not compiled with any debug 
information. If you have the source code option, you may of course recompile 
them with this option. 

We recommend compiling and linking with our debug libraries when you are 
first testing a C+O program. The C+O debug libraries trap many bugs before 
they can cause a problem. When a bug is detected an exception is generated, 
causing an exception handler to be invoked. This will typically result in the 
program displaying the filename and line number where the exception was 
detected. You will want to use Appendix A to determine the cause of the 
exception. 

Because many C+O functions are macros, you should avoid calling functions 
with parameters which have side effects such as the pre or post increment 
operators. 

Optimizing 

Optimizing your C+O program is as simple as recompiling it with the 
production compiler flag set and linking with the production libraries. Many 
C+O functions are written as macros and the production compile flag 
COBJ_PRD enables these macros. Most or all of the parameter checking to 
C+O functions is disabled as well when this flag is set. 

Because many C+O functions are macros, you should avoid calling functions 
with parameters which have side effects such as the pre or post increment 
operators. 
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Introduction 

Much has been written lately about object-oriented programming (OOP) and 
object-oriented programming languages (OOPLs). When we think of object- 
oriented programming, we probably think of SmallTalk, C++ or LOOPS 
However all of the concepts rigorously applied in those languages can be 
applied (with a little extra effort) to commercial languages such as C. And bv 
applying those concepts, we can attain the productivity benefits promised bv 
advocates of object-oriented programming while retaining the benefits of 
programming in C. 

C+O (Classes + Objects) class libraries are the first commercial products 
designed to apply object-oriented programming techniques specifically for the C 
language without requiring a pre-processor or interpreter. C+O class libraries 
are efficient and can be used to deliver commercial quality products. C+O is a 
tool for increasing your productivity by decreasing the amount of general 
purpose code you must write (and debug) for every program. It is also a tool for 
allowing you to create your own libraries of reusable code. C+O has extensive 
debugging facilities for helping you track down problems. 

Of course you may already be building "black box" code. Code which is 
insulated from other parts of a program and has a very well denned interface 
In this case, you already will be familiar with some of the concepts provided bv 
C+O class libraries. C+O offers a standard way of designing and building such 
black boxes. Its comprehensive and rich set of tools and engineering 
techniques allow you to build more flexible black boxes than ever before. 

In this section, you will learn the fundamentals of how to create and use 
reusable code with C+O class libraries. The examples presented here are all 
coded using C+O stylistic and naming conventions. After reading this section 
and working through the examples, you will have the basic knowledge needed 
to apply C+O object-oriented programming concepts to real problems, taking 
advantage of C+O reusable code libraries. 5 

m u y want t0 look at 311(1 ^ toe dem <> code provided with C+O as a means 
oi iurther enhancing your understanding of the concepts presented here. 
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Background 

The general misconception regarding object-oriented programming is that it is 
of use only for designing user interfaces or graphics packages. However, 
object-oriented programming techniques are beneficial for building any kind of 
software. Benefits include faster implementation (due to reusability), greater 
reliability (due to reusability) and better maintainability (due to encapsulation 
and dynamic binding). In short, object-oriented programming, or OOP is about 
finding better ways to modularize software while making it more reusable. 

Part of the problem in getting the word out about OOP is that to date, most of 
the work done involving OOP was written in Smalltalk. The reason that this is 
a problem, is because the terminology associated with Smalltalk is completely 
foreign to the terminology we are accustomed to from using commercial 
languages. The result is that when someone from the object-oriented 
community tries to explain to us the workings of object-oriented programming, 
it's very much like a first lesson in French — the teacher stands up there 
talking away and we're sitting there wondering what's going on. 

One other problem is the common perception that object-oriented programming 
implies high-overhead programming. Smalltalk has done much to contribute 
to that perception. It consistently applies OOP techniques to solving problems 
with about the same finesse as using a .44 magnum to kill a fly. To keep OOP 
a tool we can use efficiently, we must have an arsenal of OOP techniques 
equivalent in range from flyswatters to cannons — and we must have the 
wisdom to know which tool is right for the job. 

What makes C+O different from Smalltalk and many other object-oriented 
languages and extensions, is that first, we demystify the language of object- 
oriented programming and place it firmly back in the hands of the people 
building commercial products. Second, we provide a range of object-oriented 
solutions which keep the amount of program overhead and program complexity 
in line with the benefits they produce. In this way, you can apply the object- 
oriented solutions which best fit your particular problem. 

Before moving on, we should mention how C++ fits together with C+O class 
libraries. First of all, the benefit to using C+O class libraries is not the fact 
that it is object-oriented. The benefit to using C+O class libraries is that you 
decrease your programming effort by reusing its code. It is therefore our 
intention to provide C+O class libraries for standard-setting languages. If C++ 
becomes something of a standard, as we expect it will, we will port C+O to that 
language. When we do, we will fully adopt the object-oriented paradigms 
provided by that language. Currently however, C++ is still somewhat in a state 
of flux and their are very few vendors providing C++ compilers/pre-processors. 

C+O was developed by Objective Systems over the last two years. It was 
developed specifically to allow us to create highly reusable code which was 
efficient enough to be used in commercial product development. 
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Classes 

In explaining the object-oriented precepts behind C+O, we will always keep the 
discussion centered around the C language. We will borrow many terms from 
the OOPL vocabulary but define them in terms which a C programmer can 
quickly comprehend. It is therefore a prerequisite that you have a solid 
knowledge of C programming. It is not a prerequisite to have a knowledge of 
object-oriented programming although it will help if you have some basic 
familiarity with the subject. 

The first thing to consider are classes. A class is the fundamental unit of 
programming in object-oriented languages and we adopt the concept for C+O. 
Example 1 snows the class Point. 



struct Point { 
Mediumlnt x; 
Mediumlnt y; 

}; 

typedef struct Point Pnt; 
#define PPNT struct Point * 

Void PntSetXY{ PPNT, Mediumlnt, Mediumlnt ); 
Mediumlnt PntGetX( PPNT); 
Mediumlnt PntGetY( PPNT); 

#ifdef PNT MACROS 

#define PntGetX( pPnt ) ((pPnt)->x) 

#define PntGetX( pPnt ) ((pPnt)->x) 
#endif 



Example 1 - Point Class 



A class is defined as a structure and functions which manipulate and access 
that structure. Another word we use interchangeably with function is method. 
Only the functions (methods) associated with a class can access the structure 
members directly. Functions not belonging to a class must rely on the 
functions provided by that class for manipulating and accessing the structure. 
If we could directly represent this in C, it would be as if functions were always 
declared as part of a struct declaration. Instead, we rely on source code 
organization and naming conventions to help reiterate the relationship. This 
property of not allowing direct access to structures other than through 
methods belonging to the class is called encapsulation. 
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Referring back to Example 1, we show how the Point class would be defined in 
C+O. Hie Point class consists of a struct declaration for Point and some 
functions with the names prefixed by Pnt. Sometimes we define macros for 
simple functions. We also define a typedef for Point called Pnt (always a three 
character abbreviation) and a #define for a pointer to struct Point called PPNT. 
C+O uses this naming convention consistently throughout its classes. Finally, 
we always require that the first parameter to a Point function a pointer to 
Point. From the perspective of source code organization, we would declare the 
Point structure in a file called "pnt.h", the function declarations and (optional) 
macros in "pntmac.h", and the function definitions in "pnt.c". This makes it 
very simple to locate the definition or declaration of an item based on its prefix. 

You have now learned the single most important concept used in object- 
oriented programming. Simply, that programs are structured into classes. 
Notice there is no magic in this, it is simply a design decision which reaps 
certain benefits. Namely, it makes programs more modular and in general 
easier to understand. Programs in which functions directly access the 
implementation of more than one structure are inherently less modular and 
the code less reusable. Another benefit of classes is that it is much easier to 
change the implementation of a class without affecting a potentially enormous 
and unknown amount of code. As long as the external interface (and 
semantics) provided remains the same, other classes will not be affected. 

Of course, there is nothing preventing a C programmer from violating the class 
concept (unlike most OOPLs). C won't even warn you that a class is being 
violated. It is a matter of discipline. You must believe that its important not to 
violate the class rule and that certain benefits are provided by doing so. While 
we believe you will get more out of C+O by following this convention, it is up to 
the individual programmer to decide. 

Before continuing, it is important to note one more thing, namely, that there is 
an important psychological benefit to the class concept. Namely, it gets us 
thinking about building a program in terms of parts. Once we get into this 
mind-set, it is natural for us to want to reuse those parts in other programs or 
even within the same program. This is at the heart of what C+O is about. 

Now that we understand what a class is, we will interchangeably refer to it as a 
structure, in deference to our C background, but keeping in mind that we still 
associate with it a particular set of functions for manipulating that structure. 
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Objects 

A structure declaration has no existence of its own in a running program. Only 
when we declare variables of some structure type can we assign or retrieve 
values from the structure. We must also name the particular variable since 
there may be more than one variable declared with that same type. We refer to 
the memory allocated to a variable, whether it be external, static, automatic, or 
dynamic, as being an instance of that structure. We also refer to instances as 
objects. Example 2 shows some Point objects. 



Point x; /* An instance of Point class named x 7 

Pnt y; /* A Point object named y 7 

PPNT pPnt; /* Pointer to a Point object named pPnt 7 



Example 2 - Point Objects 

This is the second most important thing to understand about object-oriented 
programming. Namely, that while our program is structured in terms of 
classes, when it is running, it is objects which we are manipulating. 

Let's continue with the Point example and fill in the functions for manipulating 
Points. Example 3 shows two of the Point methods being defined. In C+O, 
methods always manipulate pointers to objects of the class. 



Void PntSetXY( PPNT pPnt, Mediumlnt x, Mediumlnt y ) 

pPnt->x = x; 
pPnt->y = y; 



Mediumlnt PntGetX( PPNT pPnt ) 
return pPnt->x; 



Example 3 - Point Methods 

We have now seen a complete class definition. Our example shows only a 
small number of functions for class Point. This is how most classes start out. 
Over time, you and others will add more functions, rounding out a class 
implementation. 
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Designing with Class 

One of the interesting things about classes, is how they force us to think about 
where to add a function, what types of parameters to pass, how to name it, 
what effects it will have, and so on. In other words, classes provide a structure 
for thinking about how we design and organize code. This shift of thinking 
from traditional programming tends to inspire better function and program 
design. 

A couple of words are in order regarding good class design and good design of 
functions belonging to a class. First, the class structure should reflect a single 
entity, or a single relationship. For instance a spreadsheet program would 
have classes called Cell, Formula, and Spreadsheet, among others. If you find 
yourself designing a class which ends up seeming like two or more things, 
break it apart! Any small increase in overhead will be well worth the resulting 
simplified program architecture. Look for application specific classes which 
can be broken into a non-application specific part and an application specific 
part. The former you may be able to reuse in another program. 

When designing functions, have lots of little, simple functions which perform a 
single act, rather than large functions which do many tasks. If you name your 
functions according to the task the perform, as we do in C+O, you will find that 
overly complex functions cannot be named in under 32 characters or that the 
names become rather bizarre, sounding more like a run-on sentence than a 
verb. This advice has saved us from bad design decisions on many occasions. 

Another good rule of thumb are functions which take large numbers of 
parameters. These are often suspect of being amenable to decomposition. 

Finally, and we cannot overstate this, avoid writing functions which rely on 
data other than the parameters being passed into the function. In other words, 
minimize or eliminate global variables. One way to think about this is what if 
you had to pass every global variable you accessed in your function as a 
parameter instead. Would it seem unwieldy? If so, then youVe got a function 
which is side-effect heavy. 
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Foundation 

Everything we are going to tell you from here on out concerns two related 
things: how to build classes on top of other classes and how to make instances 
oi those classes communicate with one another. You can think of this as the 
glue which binds classes together or the grease which keeps them from 
grinding against each other. Both analogies are relevant. . 

The mechanisms which allow objects to communicate are crucially important 
to the success of an object-oriented system. The reasons are this: if 
communication between objects is slow, then the system is doomed to be slow 
If communication mechanisms are limited, then the flexibility of the system is 
compromised. C+O uses a variety of mechanisms to allow objects to 
communicate. None of them are "slow". 

The mechanisms which allow classes to be built on top of other classes are also 
extremely important. For instance, if you can only build a class based on one 
other class (as many OOPLs provide), you are limited to making more and more 
refined versions of the same class. On the other hand, if you can build new 
classes from any number of other classes as C+O provides, you have a much 
more powerful system. 

Example 4 shows how a class can be built from other classes. 



struct Rectangle { 
Point origin; 
Point extent; 

}; 

typedef struct Rectangle ; 
typedef struct Rectangle Ret; 
#define PRCT struct Rectangle *; 

Void RctSetOriginAndExtent( PRCT, PPNT, PPNT ); 

Void RctGetSizeX(PRCT); 

Void RctGetSizeY(PRCT); 

Void RctGetOriginj PRCT, PPNT ); 

Ret R = {0}; 



Example 4 - Rectangle Inherits from Point Twice 



In its simplest form, building a class from another class is simply a matter of 
including the structure of one inside the other. Referring to Example 4, we say 
that the Rectangle class inherits from the Point class. When a class includes 
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This example immediately begs the question of how does one communicate 
between instances of classes. Using Example 4, the Rectangle R can be 
thought of as actually being three objects: the Rectangle R, the Point Rorigin, 
and the Point R extent. 

First, because Point is defined independently of Rectangle or any other class, 
there is no way Rorigin and Rextent can communicate directly. 
Similarly, neither Point object can communicate with R since they are unaware 
of R as well. 

Therefore, it is up to R to communicate to with both Points. Thus we have 
what we call simple inheritance. Put another way, Point has no mechanisms 
or functions for communicating with structures which include it as a struct 
member. 

Before we go any further, we need to define some terminology for the 
relationship of Rectangle to Point and Point to Rectangle. We call Rectangle the 
subclass of Point and Point (each one) the superclass of Rectangle. This 
terminology is carried over (and extended) from Smalltalk. 

These terms may seem reversed and contrary to common sense. The usage 
seems to be derived from the fact that in Smalltalk there is only one superclass 
which a class can be built upon. Thus a subclass is viewed as being a more 
restricted form of its superclass. Multiple-inheritance certainly changes this 
perspective, however we will stick by Smalltalk's definition of these terms 
rather than make matters worse by reversing them. In any case, we prefer to 
call Rectangle the client of Point and Point a server to Rectangle. 

We need to make clear that a structure cannot inherit from a structure which 
it points to, only one which is included as part of its definition. Thus, if 
Rectangle were defined as in Example 5, it would not be considered to inherit 
from Point. The reason for this is that inheritance is defined as being a 
contiguous extension of one class instance from another. There can only be 
one instance of a subclass for an instance of a superclass. In Example 5, 
changing the painter values of origin or extent would be to change the 
particular instances they inherit from. To allow otherwise would invite chaos. 



struct Rectangle { 
Point *origin; 
Point 'extent; 

}; 



Example 5 - Rectangle Does Not Inherit From Point 
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Unlike some object-oriented languages, we take the view that a subclass may 
not look inside" its superclasses). In our example, Rectangle R may not 
directly access the contents of either Point (origin or extent). Rectangle R must 
use the functions provided by the Point class when accessing Rorigin or 
Rextent. Of course there is no way for the compiler to enforce this, you must 
simply believe this rule important enough to follow. The rationale for this 
decision is simply that we don't believe there is any benefit to allowing a client 
to have direct access to its servers. The black box approach is much safer. 

Example 6a shows the wrong way for Rectangle to communicate with Point 
Example 6b shows the correct way. 



Mediumlnt RctGetSizeX( PRCT pRct ) 
return pRct->extent.x - pRct->origin.x; 



Example 6a - Violates Encapsulation Rule 

^ lediumlnt RctGc 



Mediumlnt RctGetSizeX( PRCT pRct ) 

return PntGetX( &pRct->extent ) - PntGetX( &pRct->origin ); 



Example 6b - Encapsulation Rule Satisfied 
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Finally, Example 6c goes one step further and creates a new Point function 
PntGetDiffX. This is in the spirit of creating functions which may be likely be 
reused somewhere else. One must always keep in mind that every loop, every 
calculation, every process defined may be of value to you or someone else at a 
later time. Coding the function inside of a different class helps no one. 



Mediumlnt PntGetDiffX( PPNT pPntl , PPNT pPnt2 ) 
return pPnt1->x - pPnt2->x; 

} 

Mediumlnt RctGetSizeX( PRCT pRct ) 

return PntGetDiffX( &pRct->extent, &pRct->origin ); 
} 

Example 6c - Maximizes Reusability by Creating New Point Method 
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Advanced Inheritance 

More complicated structures can be created which require more sophisticated 
styles of interplay than previously described. Example 7 shows the classes 
Node and BinaryTree (for a complete discussion of binary trees, see Knuth, The 
Art of Computer Programming, Volume 1). 



#define PBIN struct BinaryTree * 
#define PNOD struct Node* 

struct BinaryTree { 
Object obi; 
PBIN left; 
PBIN right; 

}; 

typedef struct BinaryTree BinaryTree; 
typedef struct BinaryTree Bin; 



struct Node { 
Object obj; 
PSTR name; 
BinaryTree bin; 

}; 

typedef struct Node Node; 
typedef struct Node Nod; 



Example 7 - Node and Binary Tree Classes 

A binary tree has left and right pointers to other binary trees. The left subtree 
is shown as being connected to its branch with a vertical arrow, the right 
subtree is shown as being connected to its branch by a horizontal arrow. 

In Example 7, Node is inheriting BinaryTree. The inclusion of Object structure 
members in both classes signifies a more complex form of inheritance than we 
have encountered before. It is a requirement for this type of inheritance that 
the Object structure members be the first member of the structure. It is the 
Object class which gives other classes their object-oriented characteristics. 
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Example 8 shows how we create new instances of type Node with the function 
_NodNew. We prefix the function name with an underscore to easily identify it 
as a Node function which does not take a Node pointer as its first argument. 
The function Binlnit is used to initialize an instance of Bin and should always 
be the first Bin function called after allocating memory for the object. 



Void Binlnit( PBIN pBin ) 

pBin->left - pBin->right - NULL; 

} 

PNOD _NodNew( PSTR name ) 

* PNOD pNod; 

pNod = (PNOD) ClsNewObject( NodCIs ); 
Binlnit( &pNod->bin ); 

pNod->name = malloc( strlen( name ) + 1 ); 
cpystr( pNod->name, name ); 



a = _NodNew( "a" ); b = _NodNew( "b" ); 
c = _NodNew( "c" ); d = _NodNew( "d" ); 
e = _NodNew( "e" );f = _NodNew( T ); 
g = _NodNew( "g" ); h « _NodNew( "h" ); 



Example 8 - Creating Nodes 

The variable NodCIs (referenced in _NodNew) is a pointer to an object of type 
Class and is initialized soon after the program starts up. Class objects are 
used to create and initialize instance of classes in C+O. Later we will show you 
how to create the Class instance NodCIs. The function ClsNewObject allocates 
memory for an object as specified by NodCIs. 
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Now that we've created some Nodes, we need functions to manipulate them. 
Example 9 shows some BinaryTree methods for connecting up BinaryTrees to 
the left and right subtrees. It also shows the equivalent Node functions. In 
effect, we are demonstrating how Node is inheriting some behavior (functions) 
from BinaryTree. The Node functions NodSetLeft and NodSetRight would 
typically be defined as macros for efficiency. 



Void BinSetLeft( PBIN pBin, PBIN pBinLeft ) 
pBin->left = pBinLeft; 

Void BinSetRight( PBIN pBin, PBIN pBinRight ) 
pBin->right = pBinRight; 

Void NodSetLeft( PNOD pNod, PNOD pNodLeft ) 
BinSetLeft( &pNod->bin, &pNodLeft->bin ); 

Void NodSetRight( PNOD pNod, PNOD pNodR ) 
BinSetRight( &pNod->bin, &pNodR->bin ); 



NodSetRight( a, b ); 
NodSetRightj b, c ; 
NodSetLeft( a, d ); 
NodSetLeft( d.e); 
NodSetRight( e, f ); 
NodSetLeft( c, g ); 



Example 9 - Node Inherits Behavior From BinaryTree 
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For Node to communicate with BinaryTr ee is a relatively trivial matter as we 
have seen. But now, we need a way for BinaryTree to communicate back to 
Node if we are to use BinaryTree access methods. Example 10 shows the 
problem. 



PBIN BinGetLeft( PBIN pBin ) 
return pBin->left; 

} 

PNOD NodGetl_eft( PNOD pNod ) 

return BinGetLeft( &pNod->bin, NodOffset ); 



Example 10 - Wrong Way to Implement NodGetLeft 
In Example 10, BinGetLeft returns a pointer to a BinaryTree, not a Node. 
Therefore the implementation of NodGetLeft is incorrect, it is returning a 
BinaryTree pointer instead of a Node pointer. What we need is a mechanism 
by which Bin can return to us Node pointers. Example 1 1 shows how we do 
this with C+O. 



POBJ BinClientGetLeft( PBIN pBin, Mediumlnt offset ) 
return ObjGetClientOrNull(&pBin->left->obj,offset); 

} 



PNOD NodGetLeft( PNOD pNod ) 

* return (PNOD) BinClientGetLeft( &pNod->bin, NodOffset ); 
} 



Example 1 1 - Simple Communication From BinaryTree to Node. 



What's going on here? Simply that BinaryTree is storing BinaryTree pointers 
(left and right). But because each BinaryTree is a superclass of Node (we 
assume a homogeneous BinaryTree), we can compute the Node pointer from a 
BinaryTree pointer by adding an offset to the BinaryTree pointer . The function 
ObiGetClient does just that. It adds the (negative) offset to the object pointer to 
yield a new object pointer. Note that we must cast the Object pointer returned 
by BinClientGetLeft to a Node pointer. This is why the Object superclass must 
always be the first member of a structure. 
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Table 1 shows the memory layout for the objects of class Node and BinaryTree. 
Each structure member is of a fixed size and a fixed offset. Therefore, if we 
know the address of a structure member, we can compute the address of the 
structure which includes it. (Sizes shown are for the small memory model.) 



Class 


Size 


Mem 


Size 


Offset 


Description 


Nod 


10 


obj 


2 


0 








name 


2 


2 








bin 


6 


4 


The value of NodOffset 


Bin 


6 


obj 


2 


0 








left 


2 


2 








right 


2 


4 





Table 1 - Memory Layout for Node and BinaryTree Objects 

The offset value NodOffset gets computed automatically in the early stages of 
the program (something we will describe later). On first glance, having to pass 
in offsets may seem a bit of a nuisance. Keep in mind though that BinaryTree 
is being written independently of Node. We would like to build other classes on 
top of BinaryTree, and they will have different offsets. 

C+O has facilities for allowing us to ignore offsets (with no additional cost in 
complexify or storage), but we typically would not do this. The reason is 
because offsets have a performance advantage when multiple levels of 
inhentance occurs, which typically is quite often. For example, we might want 
to allow Node to be inherited by another class. This means we need to add a 
(negative) offset to Node pointers to get client structure pointers. Example 12 
shows how this works in practice. 



POBJ NodClientGetLeft( PNOD pNod, Mediumlnt offset ) 
return BinClientGetLeft( &pNod->bin, NodOffset + offset ); 



Example 12 - Inheritable Node routine 



In Example 12, to get the client structure pointer of the left subnode of pNod 
we get the left subtree of the BinaryTree pNod.bin, add NodOffset to get the left 
subnode of pNod, then add offset to get the client structure of that subnode. 
When these type of functions get converted into macros, the resulting code is 
very efficient. 6 
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Visiting Objects 

We now understand how a class can communicate with its client, albeit in an 
indirect way. Now let's see how a class can call a client function. Example 13 
shows how this can be done. 



Void BinClientVisitPreOrder(PBIN pBin.Mediumlnt offset.PBLK pBlk) 

{ PBIN left; 
PBIN right; 

if ( !pBin ) 
return; 
left = pBin->left; 
right = pBin->right; 

BlkExecute( pBlk, ObjGetClient( pBin, offset ) ); 
BinClientVisitPreOrder( left, offset, pBlk ); 
BinClientVisitPreOrder( right, offset, pBlk ); 



Void NodVisitPreOrder( PNOD pNod, PBLK pBlk ) 
BinClientVisitPreOrder( &pNod->bin, NodOffset, pBlk ); 

} 

Void NodPrintPreOrder( PNOD pNod ) 

* Block blk; 

Blklnit( &blk, NodPrint ); 
NodVisitPreOrder( pNod, &blk ); 
BlkDelnit( &blk ); 

} 

Void NodPrint( PNOD pNod ) 

printf( "Node is %s\n", pNod->name ); 



Example 13 - Node Visit Function 
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Before we talk about what the BinClientVisitPreOrder and NodVisitPreOrder 
function are doing, we need to introduce a new class called Block. A Block 
object can store a function pointer and several arguments. At some later time, 
a call to BlkExecute will cause the stored procedure to be executed and any 
parameters stored in the Block will be passed along to it. The first parameter 
sent to the function is a pointer which is passed in at the time BlkExecute is 
called. BlkExecute behaves much like an indirect function call. 

Ok, now back to BinClientVisitPreOrder and NodVisitPreOrder. These are what 
we call traversal functions. A traverse function is said to walk the nodes of a 
data structure in some predefined order. As we walk the data structure we 
visit each node along the way. (We use the term node generically and Node to 
refer to the Node class). 

In Example 13 what happens is the following. BinClientVisitPreOrder walks 
the binaiy tree in pre-order. (Pre-order is just one of many ways to visit all the 
nodes of a binary tree.) To visit a node, it calls the function BlkExecute 
passing it the client of the BinaryTree node being visited. BlkExecute will call 
the client function (established by Node) passing the object pointer it receives 
as a parameter. In this way, BinClientVisitPreOrder is calling (visiting) a Node 
function and passing it a Node pointer for each BinaryTree. 
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Sending Messages 

In our next example, we show how a client can inherit behavior through 
messages from a server class as well as override default behavior for a server 
class. 

In Example 14a and 14b we show two different methods for deallocating nodes 
of a BinaryTree. Only one of them is correct. In both cases, the function 
ObjDestroy function is called to deallocate the object. ObjDestroy is always 
used to deallocate objects created by ClsNewObject. 

In the incorrect one, Example 14a, BinDestroy tries to free BinaryTree objects. 
However, the BinaryTree object is part of a larger object that was allocated, 
namely a Node. Therefore, the call to ObjDestroy will not succeed (it can tell if 
there is a subobject). Worse, even if that could work, the Node has additional 
allocated memory which must be reclaimed prior to the Node being freed. 



Void BinDestroyAII( PBIN pBin ) 

{ Block blk; 

Blklnit( &blk, BinDestroy ); 
BinClientVisitPreOrder( pBin, 0, &blk ); 
BlkDelnit( &blk ); 



Void BinDestroy( PBIN pBin ) 

ObjDestroy( &pBin->obj ); /* This is an error 7 



Example 14a - Wrong Way to Free Nodes 
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Example 14b shows how a Node function could deallocate itself and all its 
subnodes. But is there any way we could write BinDestroyAU so that it works 
properly? 



Void NodDestroyAII( PNOD pNod ) 

* Block blk; 

Blklnit( &blk, NodDestroy ); 
NodVisitPreOrder( pNod, &blk ); 
BlkDelnit(&blk); 



Void NodDestroy( PNOD pNod ) 

free( pNod->name ); 
ObjDestroy( &pNod->obj ); 



Example 14b - How to Destroy All the Nodes in a BinaryTree 



The answer is yes. The solution is to have the BinaryTree object send a 
message requesting that the object be freed. Sending a message is like calling 
a function except you're not sure the exact function which will be called. This 
may sound confusing. However, it is up to the function which gets invoked to 
make sure the action you requested takes place. This process of choosing the 
function at run-time rather than at compile time is called dynamic binding. 
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By default, if Binaiytree has no subclass, the destroy message 
(MSG_BIN_DESTROY) will call BinDestroy. But Node overrides this message 
with its own function NodDestroy which does the appropriate cleanup and 
frees the node. (We are just about ready to show you how all this is done, so 
hang on.) Example 15 shows the code which implements this properly. 



Void BinDestroyAII( PBIN pBin ) 

* Block blk; 

Blklnit( &blk, BinSendDestroy ); 
BinClientVisitPreOrder( pBin, 0, &blk ); 
BlkDelnit( &blk ); 

} 

#define MSG_BIN_DESTROY 0 
Void BinSendDestroy( PBIN pBin ) 

Block blk; 

Blklnit( &blk, NULL ); 

ObjSendMessage( &pBin->ob], MSG_BIN_DESTROY, pBlk); 
BlkDelnit(&blk); 

} 



Example 15 - Sending a Message 



This demonstrates how an object's default behavior can be changed by a client 
class without changing the code for the server class. This extends the ability to 
make reusable classes even more general and feature rich than they otherwise 
could be. 
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MetaClass 

At this point we need to explain how Object and Class classes understand so 
much about structures and offsets and how they can send messages to one 
another. C+O provides a number of classes which allow this behavior to be 
denned. Hie first class to examine is MetaClass. 

The MetaClass class is used to define the structure of a class, characteristics of 
objects of that structure type, superclasses of that class, and messages which 
it inherits and may be inherited by other classes. Example 16a shows the 
MetaClass definition for BinaryTree. You may wish to refer to the reference 
sections on MetaClass, MetaMessage, and MetaSuperClass for a complete 
description of the structure members of these classes. 



r MetaMessages for class BinaryTree */ 
Mms BinMmsfJ = { 

{ MMS_CHECK_WORD, /* Default value 7 

NULL, /* Superclass msg to override 7 

"destroy", /* Name of message 7 

j BinDestroy /* Default method for message 7 

}; 

/* MetaClass instance for class BinaryTree 7 

Mcl BinMcl = { 

MCL_CHECK_WORD, /* Default value 7 

"BinaryTree", /* Name of class being described 7 

sizeof(Cls), r Default value 7 

sizeof(Bin), /* Size of class instance 7 

BinMms, /* Array of MetaMessages 7 

1 . /* Number of messages 7 

NULL, r NULL if no superclasses 7 

?• ,^ /* Number of superclasses 7 

MclCreateCIs, /* Default class creation func 7 

CIsDestroy /* Default class destruct func 7 

}; 



Example 16a - MetaClass Definition for BinaryTree 

£r Me J? CIass consists of toree components: MetaSuperClass definitions a 
MetaMessage definitions, and a MetaClass definition (which references the 
MetaMessage and MetaSuperClass definitions). 

In Example 16a, BinaryTree has no superclasses (other than Object which is 
always assumed), therefore no MetaSuperClass definition appears. 
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The MetaMessage definition (BinMms) defines one message called destroy for 
the BinaryTree class. The default method which will be executed when this 
message is sent is BinDestroy. However, a subclass may (and should in this 
example) override that message as we will see shortly. The index of the 
MetaMessage in BinMms is how you identify a message when a BinaryTree 
object wishes to send a message. That is why MSG_BIN_DESTROY had the 
value 0 in Example 15b. 

The MetaClass definition (BinMcl) defines the size of an instance of type 
BinaryTree. The other values given are defaults (see MetaClass reference 
section for more details). 

Instances of MetaClass, MetaMessage, and MetaSuperClass (not shown above) 
are always defined statically. There should be one instance of a MetaClass 
(and associated MetaMessages, and MetaSuperClasses) for each class you 
define. Primitive classes need not have a MetaClass as they never 
communicate with their subclasses. 
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Example 16b shows the MetaClass definition for the class Node. In it we see 
that it has one superclass, BinaryTree and overrides one message, "destroy". 



Node NodDummy = {0}; /* Example Node instance 7 

Mediumlnt NodOffset = 0; r Offset of Bin superclass 7 

r MetaSuperClasses for class Node 7 
Msc NodMscfJ = 

{ MSC_CHECK_WORD, r Default value 7 

"£}£i n M r Name of superclass instance 7 

(POBJ) &NodDummy, I* Example instance of Node 7 

(POBJ) &NodDummy.bin, /* Example instance of superclass 7 

&NodOffset /* Store superclass offset here 7 



} 

I* MetaMessages for class Node 7 
Mms NodMmsQ = { 

{ MMS_CHECK_WORD, /* Default value 7 

"Bin", /* Override Bin destroy 7 

"destroy", /* Name of message 7 

j NodDestroy /* Method to override message 7 

}; 

I* MetaClass instance for class Node 7 
Mcl NodMcl = { 

MCL_CHECK_WORD, r Default value 7 

"Node", /* Name of class being described 7 

sizeof(Cls), r Default value 7 

sizeof(Nod), r Size of class instance 7 

NodMms, /* Array of MetaMessages 7 

1 . /* Number of messages 7 

NodMsc, /* Array of MetaSuperClasses 7 

J . ^ „ r Number of superclasses 7 

MclCreateCIs, /* Default class creation func 7 

CIsDestroy /* Default class destruct func 7 



Example 16b - MetaClass Definition for Node 
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The variable NodDummy is used in the initialization of the MetaSuperClass 
instance. It is used to calculate the offset of the BinaryTree superclass from 
the beginning of the Node structure. This offset is computed when 
MclCreateClass is called (for NodMcl) and the resulting value is stored in 
NodOffset. 

By overriding the message "destroy", an ObjSendMessage call by an instance of 
BinaryTree will result in a call to NodDestroy, passing it not a Bin pointer, but 
a Nod pointer. If Node were to be subclassed by another structure and Node's 
destroy message was overridden, then that function would be called with a 
pointer to that class instance. This can go on for as many levels as need be. 

During program initialization, we must call MclCreateClass, passing it an 
instance of a MetaClass. It creates and returns a pointer to an object of type 
Class. Example 17 shows how this occurs. 



Class *NodCls = {0}; 

NodCIs = MclSendCreateClass( &NodMcl ); 



Example 17 - Creating a Class Instance for Node 



Objects of type class are used to create instances of a specific structure. In 
this case, NodCIs can be used to create objects of type Node as we saw in 
Example 8. 

Remember, we only need to define MetaClass definitions and Class instances 
for class types which we wish to communicate with subclasses or when we are 
inheriting classes which have MetaClass definitions. Primitive classes, like our 
Point and Rectangle examples, do not need such definitions. C+O classes 
which do not need MetaClass definitions are labeled as a Primitive Class in 
their class reference section. 
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Frameworks 

Next we show how a class can define a framework for subclasses to follow. A 
framework is also known as an abstract superclass. 

Example 18 shows a class named DisplayShape. DisplayShape implements 
the basic behavior common to all types of display shapes. It is like any other 
class with the following exception. It defines messages which are not 
implemented by the class and therefore must be provided by a client. This is 
signified by making the method structure member of a MetaMessage be NULL. 



#define PDSH struct DisplayShape * 
struct DisplayShape { 

Object obj; 

Point mbr; 

}; 

typedef struct DisplayShape DisplayShape; 
typedef struct DisplayShape Dsh; 



Mms DshMmsf] = { /* Messages for class DisplayShape 7 
" MMS_CHECK_WORD, NULL, "destroy", NULL }, 
MMS_CHECK_WORD, NULL, "display", NULL}, 
MMS_CHECK_WORD, NULL, "erase", NULL}, 
. MMS_CHECK_WORD, NULL, "rotate90", NULL } 

}» 

Mcl DshMcl = { 

MCL_CHECK_WORD, 
"DisplayShape", 
sizeof (Class), 
sizeof(DisplayShape), 
DshMms, 

sizeof(DshMms)/sizeof(Mms), 

NULL, 

0, 

MclCreateClass, 
CIsDestroy 

}; 



Example 18 - DisplayShape Framework Class 

In general, and DisplayShape in particular, you cannot create instances of a 
framework. Instead, you create instances or clients (subclasses) of frameworks. 
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In Example 19, we define a client class of DisplayShape called RectangleShape. 
RectangleShape inherits from DisplayShape and provides the display shape - 
specific functions display, erase, and rotate90. These functions must be 
rewritten by each class which inherits from DisplayShape. 



#define PRSH struct RectangleShape * 
struct RectangleShape { 

Object obj; 

Rectangle ret; 

DisplayShape dsn; 

}; 

typedef struct RectangleShape RectangleShape; 
typedef struct RectangleShape Rsh; 

Rsh RshDummy = {0}; 

Medium Int RshOffset = 0; r Holds Dsh offset 7 

Msc RshMscQ = { 

{ MSC_CHECK_WORD, 

"Dsh", 

&DshMd, 

(POBJ) &RshDummy, 
(POBJ) &RshDummy.dsh, 
&RshOffset } 

}; 

Mms RshMms[] = { 

MMS_CHECK_WORD, "Dsh", "destroy", RshDestroy }, 
MMS_CHECK_WORD, "Dsh", "display", RshDisplay }, 
MMS_CHECK_WORD, "Dsh", "erase", RshErase }, 
. MMS_CHECK_WORD, "Dsh", "rotate90",RshRotate90" } 

}; 

Mcl RshMcl = { 

MCL_CHECK_WORD, 
"RectangleShape", 
sizeof (Class), 
sizeof (RectangleShape), 
RshMms, 

sizeof(RshMms)/sizeof(Mms), 
Rsh Msc, 

sizeof(RshMsc)/sizeof(Msc), 
MclCreateClass, 
CIsDestroy 

}; 



Example 19 - Client Class RectangleShape 
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By creating a separate class for each display shape, we have factored display 
shapes into two type of code. That which is applicable to all display shapes 
regardless of type, and that which is specific to a particular display shape. 
This kind of factoring makes programs much more modular and 
understandable. It also makes adding new kinds of display shapes very easy. 

In Example 20 we see how DisplayShape actually relies on the messages erase 
and display to implement the move function. Implementing the move fiinction 
in this manner allows us to not have to rewrite it for each display shape! 



Void DshMove( PDSH pDsh, PPNT pPnt ) 
Block btk; 
Blklnit( &blk, NULL ); 

ObjSendMessage( &pDsh->obj, MSG_DSH_ERASE, &blk ); 
PntAddPnt( &pDsh->origin, pPnt ); 

ObjSendMessage( &pDsh->obj, MSG DSH DISPLAY, &blk ); 
BlkDelnit( &blk ); 



Example 20 - DisplayShape Creates a Framework for Moving Shapes 

We have now seen how a class can be written which relies on client classes to 
perform some of the work. Such classes are called frameworks, or abstract 
superclasses. The benefit to this is that we can write programs which 
manipulate abstract objects of which there may be an unknown number of 
specific types. As new types are needed, they can easily be added into the 
system with almost no changes to the existing code. 

Next, we show how to override messages which have the same name in 2 or 
more superclasses. 
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Overriding Messages and Multiple Inheritance 

Multiple Inheritance (conceptually) creates a slight problem when we have two 
or more superclasses which define the same message. The problem is that we 
need precision control when overriding messages so that we know exactly 
which superclass we are referring to when overriding a message. We also want 
to make sure that a message overridden by a subclass will trickle-down 
appropriately to the superclasses. Many OOPLs have a problem with multiple 
inheritance for this reason. C+O provides a great deal of control so that no 
ambiguity arises when overriding messages. 

In Example 21, we see how the C+O class Edge overrides the destroy message 
from the three ListElements it inherits from (refer for a moment to the 
reference section on Edge, specifically the section on Class Implementation). 



Msc EdgMscfl = { 

{ MSC_CHECK_WORD, 

"GrfLel", 

&LelMd, 

(POBJ) &EdgDummy, 
(POBJ) &EdgDummy.grfLel, 
&EdgGrfLelOffset 

{' MSC_CHECK_WORD, 
"VtxInLel", 
&LelMcl, 

(POBJ) &EdgDummy, 
(POBJ) &EdgDummy.vtxlnLel, 
&EdgVtxlnLelOffset 

{' MSC_CHECK_WORD, 
"VtxOutLel", 
&LelMcl, 

(POBJ) EdgDummy, 

(POBJ) &EdgDummy .VtxOutLel, 

SEdgVtxOutLelOffset 

} }; 

Mms EdgMmsQ = { 

{ MMS_CHECK_WORD, "GrfLel", "destroy", EdgDestroy }, 
MMS_CHECK_WORD, "VtxInLel", "destroy", EdgDestroy }, 
MMS_CHECK WORD, "VtxOutLel", "destroy", EdgDestroy } 

}; 



Example 21 - Edge Class Overrides the Same Message 
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Edge defines three superclasses, all of them UstElements. Each one is named 
differently: GrfLel, VtxInLel, and VtxOutLel. This allows us to select between 
superclasses by name without ambiguity. 

Edge also defines three MetaMessages. Each MetaMessage can override a 
message from one and only one superclass. Therefore, the destroy message 
inherited by each ListElement must be overridden by a separate MetaMessage. 
Any one of the ListElement superclasses may send the destroy message to 
Edge so each one must be overridden explicitly. 

Note that while we chose to override all three messages with the identical Edge 
function (EdgDestroy), we could have used a different Edge function for each 
one. This is very flexible and in practice quite useful. 

But what happens when a client class of Edge overrides the destroy message? 
First of all, let's make clear that the client class of Edge cannot specify the 
particular destroy message to override. We don't even want the client class to 
care that there is more than one destroy message — that is simply a function of 
the implementation of Edge. 

The first destroy message which is found in the MetaMessage table can always 
be overridden by the client class. In our example then, a client of Edge could 
override the destroy function associated with GrfLel. So if the GrfLel 
ListElement were to send a destroy message, it will be properly routed to the 
client of Edge. But how about VtxInLel and VtxOutLel. 

C+O uses the following algorithm to determine how to override the other 
destroy messages. If subsequent destroy messages listed for Edge have 
identical semantics (i.e. they call the same function as the first), then they will 
be overridden by a client class as well. Because in our example they do, 
destroy messages sent by VtxInLel and VtxOutLel will be overridden too. Note 
that because Edge has three identical messages it can choose one of three 
values for the destroy message and still call the same function. 

The search for identical messages stops on the first non-match. Therefore, you 
should always group messages with the same name together. 
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What's In a Name? 

One of the things that can help a programmer better understand his own code, 
or that of others, is if functions get named according to some conventions. 

In C+O we have developed a naming system which strives to be consistent not 
only within a class, but across classes. The following are some names which 
get used consistently throughout C+O. 

Init. Init functions are always used to initialize newly allocated memory. Each 
class should have an init function and should require that it be the first 
function to call prior to using any other functions for an object. The init 
function should initialize an object sufficiently so that it can be used by other 
functions. Init functions never return a value. 

Delnit. This is the inverse of the Init function. Delnit is always capitalized as 
shown. It should be the last function called on an object just prior to 
deallocating its memory. Every class should provide a Delnit function and 
should require its usage prior to deallocation. Delnit should deallocate any 
memory 

allocated to the object (other than the memory for the object). It should also 
ensure (to whatever degree possible) that it is not referenced by any other 
objects. Using an object which has been deinitialized is equivalent to using an 
object that has not been initialized and should result in an exception being 
triggered. Delnit functions never return a value. 

Create. Create functions are used to create instance of other objects. For 
example, MclCreateCls creates objects of type Class. The return value from a 
Create function should always be a pointer to the newly created object. Create 
functions should always call the appropriate Init function before returning the 
object pointer. Most classes should create objects by calling ClsCreateObject. 

Destroy. Destroy functions deinitialize and deallocate (lie memory for an 
object. The object should not be accessed after being destroyed. Destroy 
functions should first Clear the object or otherwise prepare it for 
deinitialization. It should then be deinitialized and finally the memory should 
be deallocated by calling ObjDestroy (assuming the object was allocated by 
ClsCreateObject). The Destroy function for a class always destroys an object of 
that type. Destroy functions never return a value. 

Clear. Clear functions are provided by most every class and are used to set an 
object back to its state just after initialization. 

Get. Get functions are used to retrieve values from an object. Typically the 
values are stored in the object but they may be calculated in some way as well. 
Get functions should always return something. 
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Is, Has, Can, etc. These functions are generally used to query an object about 
its state. For example, DllIsEmpty answers the question. "Is the list object 
empty?". The function name is always worded as a question to be answered. 
The return value is always a Bool. 

Visit. Visit functions traverse an object which has some structure to it. Visit 
functions always take a Block object as a parameter, executing the Block for 
each object to be visited. 

Client. Client functions are provided by classes which use advanced 
inheritance techniques to achieve reusability. Client Get functions always 
return objects which are a subclass of the object. Client Visit functions always 
visit the subclass objects of an object and so on. 

Range. Range functions have no special function except to imply that two of 
the arguments to a function represent a beginning and ending element and all 
the elements in between. 



Conclusion 

This concludes our introduction to using C+O object-oriented programming 
facilities. For further examples, specifically on the use of individual classes in 
C+O, you may wish to look at the sample code provided with this package. C 
source code prefixed with TST demonstrates the use of many of the C+O 
classes. 
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Structure Name: 



Block 



Abbreviation: 



Blk 



Class Type: 



Primitive Class 



introduction 

The Block class is used to hold a function pointer and parameters to pass to 
that function. A block can be passed to other functions which have no 
knowledge of the contents of the block. The block can subsequently be asked 
to execute the function, passing the parameters stored with it. 

Blocks are used as part of the messaging sending mechanism. They are also 
used by Visit functions (see Tree for extensive examples). You may wish to use 
them when creating your own Visit functions for a Class. 

The term Block is a carryover from Smalltalk. Smalltalk uses them to 
implement user-definable control structures. In effect, that's exactly what 
Blocks allow you to do. 

MetaClass, along with Class, Object, Message, MetaSuperClass, MetaMessage, 
and Block collectively define and implement the object-oriented properties of 
inheritance and dynamic binding (messaging) in C+O class libraries. 
Encapsulation, while supported by the above code, can be implemented by the 
programmer simply writing enough functions for a structure to obviate the 
need to access the structure members directly. These classes should be studied 
as a group to understand how C+O implements object-oriented C programs. 
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Block 



Description 

A Block can hold up to 16/32 bytes (depending on memory mode) of 
parameters to pass to a function. The object pointer which gets passed to 
Block on an execute call does not take up parameter space in the block. 

A Block may not call functions where the funtion called pops the arguments off 
the stack. This should not be a problem unless the function being called is 
declared with the Pascal keyword. Later releases of C+O may remove this 
restriction. 



Glossary and Special Terms 

There is no special glossary for Block. Instead, refer to the tutorial section on 
object-oriented techniques in C+O. 

Class Implementation Block 



Instance Variables 

The following is the data structure definition for a Block. 

struct Block { Mediumlnt blkCheck; 

PMTH method; 

USmalllnt index; 

UMediumlnt parmsfl;} 

blkCheck Uniquely identifies Block instances 

method Function to call 

index Keeps track of how many parameters have been pushed 

parms An array for storing parameters 

Superclasses 

The Block class is primitive and has no superclasses. 

Messages and Responses 

The Block class is primitive and has no messages. 

Class Variables 

The Block class has no class variables. 
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Function Listing In Alphabetic Order 



Function Name Description Page Scope Macro 



mi At — 

BlkClear 


Clear instance 


Blk 


•2 


Public 


N 


BlkDelnit 


Deinitialize instance 


Blk 


•3 


Public 


N 


BlkExecute 


Execute method with parameters 


Blk 


■4 


Public 


N 


BlkExecuteRetBool 


Execute the method, return int 


Blk 


•5 


Public 


N 


BlkExecuteRetDataPtr 


Execute method, return mem pointer 


Blk 


-6 


Public 


N 


BlkExecuteRetFuncPtr 


Execute method, return function ptr 


Blk 


•7 


Public 


N 


BlkExecuteRetlnt 


Execute method, return int 


Blk - 


•8 


Public 


N 


BlkHasMethod 


Return True if instance has non-NULL method 


Blk 


■9 


Public 


I N 


Blklnit 


Initialize instance 


Blk- 


•10 


Public 


N 


BlkPrint 


Print contents of instance 


Blk- 


11 


Public 


N 


BlkPushDalaPtr 


Save pointer parameter 


Blk- 


12 


Public 


N 


BlkPushFuncPtr 


Save function pointer parameter. 


Blk- 


13 


Public 


N 


BlkPushLargelnt 


Save Largelnt parameter 


Blk- 


14 


Public 


N 


BlkPushMediumlnt 


Save Mediumlnt parameter 


Blk- 


15 


Public 


N 


BlkSetMetnod 


Set the function to call 


Blk- 


16 


Public 


N 



Function Listing By Scope 

Public Functions 



Function Name 


Description 


Page 


Macro 


BlkClear 


Clear instance 


Blk -2 


N 


BlkDelnit 


Deinitialize instance 


Blk -3 


N 


BlkExecute 


Execute method with parameters 


Blk -4 


N 


BlkExecuteRetBool 


Execute the method, return int 


Blk -5 


N 


BlkExecuteRetDataPtr 


Execute method, return mem pointer 


Blk -6 


N 


BlkExecuteReFuncPtr 


Execute method, return function ptr 


Blk -7 


N 


BlkExecuteRetlnt 


Execute method, return int 


Blk -8 


N 


BlkHasMethod 


Return True if instance has non-NULL method 


Blk -9 


N 


Blklnit 


Initialize instance 


Blk • 10 


N 


BlkPrint 


Print contents of instance 


Blk -11 


N 


BlkPushDataPtr 


Save pointer parameter 


Blk -12 


N 


BlkPushFuncPtr 


Save function pointer parameter. 


Blk -13 


N 


BlkPushLargelnt 


Save Largelnt parameter 


Blk -14 


N 


BlkPushMediumlnt 


Save Mediumlnt parameter 


Blk -15 


N 


BlkSetMetnod 


Set the function to call 


Blk -16 


N 
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Private Functions 



None 









Undocumented Functions 



None 





Friend Functions 






None 









Listing Of Functions by Category 

Initialization Functions 
Function Name Description Page Scope Macro 



BIkClear 


Clear instance 


Blk-2 


Public 


N 


BlkDelnit 


Deinitialize instance 


BIk-3 


Public 


N 


Blklnit 


Initialize instance 


Blk-10 


Public 


N 




Execute Functions 








Function Name 


Description 


Page 


Scope Macro 


BlkExecute 


Execute method with parameters 


Blk-4 


Public 


N 


BlkExecuteRetBool 


Execute the method, return int 


Blk-5 


Public 


N 


BlkExecuteRetDataPtr 


Execute method, return mem pointer 


Blk-6 


Public 


N 


BIkExecuteRetFuncPtr 


Execute method, return function ptr 


Blk-7 


Public 


N 


BlkExecuteRetlnt 


Execute method, return int 


Blk-8 


Public 


N 




Query Functions 








Function Name 


Description 


Page 


Scope Macro 


BlkHasMethod 


Return True if instance has non-NULL method 


Blk-9 


Public 


N 
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Debug Functi ns 

Function Name Description Page Scope Macro 



BlkPrint 


Print contents of instance 


Blk-11 


Public 


N 


Push Functions 

Function Name Description Page Scope Macro 


BlkPushDataPtr 

BlkPushFuncPtr 

BlkPushLargelnt 

BlkPushMediumlnt 

BlkSetMethod 


Save pointer parameter 
Save function pointer parameter. 
Save Largelnt parameter 
Save Mediumlnt parameter 
Set the function to call 


Blk-12 
Blk-13 
Blk-14 
Blk-15 
Blk-16 


Public 
Public 
Public 
Public 
Public 


N 
N 
N 
N 
N 


Listing Of Functions With 


Macros Available 



None 
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Structure Name: 



Class 



Abbreviation: 



CIs 



Class Type: 



Primitive Class 



Introduction 

The class Class is used to create instances of objects. This is probably all you 
will ever use Class for unless you are writing functions for the class Object 

Instances of Class are created by calling MclCreateClass and passing in an 
MetaClass instance which describes the Class. 

MetaClass, along with Class, Object, Message, MetaSuperClass, MetaMessage, 
and Block collectively define and implement the object-oriented properties of 
inheritance and dynamic binding (messaging) in C+O class libraries. 
Encapsulation, while supported by the above code, can be implemented by the 
programmer simply writing enough functions for a structure to obviate the 
need to access the structure members directly. These classes should be studied 
as a group to understand how C+O implements object-oriented C programs. 
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Class 



Description 

A function of Class is to describe or model the organization of a particular C 
structure. Since C structures can be organized hierarchically, we must define 
the structure Class, which models this hierarchy, in a hierarchical, recursive 
fashion similar to how one might describe a tree structure. To borrow from Tree 
terminology, a class may have a parent class and children classes. Figure 1 
shows an example of this hierarchy. 

Root Subclass 



Struct X | Object Obj 

Mediumlnt m; 

Struct A a; 

Struct B b; j 

Struct A | Object Obj 

Struct Q $ { 




B) Simple Class 



Simple Class 



Figure 1 



The Class structure does not try and model the complete description of a 
structure. It is only interested in modelling superclasses which are described 
with MetaClasses. Therefore, structure components such as ints, or even 
structures like JidianTime would not be described by a Class. 

A MetaClass has one instantiation for each structure being defined. A Class on 
the other hand, has one instance per use of the structure. Therefore if a 
structure X is included in three other structures, there would be three 
instantiations of the Class X. 

Glossary and Special Terms 

The Class hierarchy has its own special terminlogy for a parent Class and 
children Classes. If X is an instance of Class, then the parent of X is called Xs 
subclass and the children of X are called Xs superclasses. X is said to inherit 
from its superclasses. If X has no subclass, it is the root subclass. If X has no 
superclasses, it is a simple class. 



For other definitions, see the tutorial section on object-oriented techniques. 
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Class Implementation Class 

Instance Variables 

The following is the data structure definition for a Class. 



struct Class { Mediumlnt clsCheck; 

PMCL mcl; 

PCLS subCIs; 

Mediumlnt subOffset; 

PCLS mostSubCIs; 

Mediumlnt mostSubOffset; 

Mediumlnt sublndex; 

PCLS *superClsArray; 

PMSG msgArray; } 



clsCheck Uniquely identifies Class instances, 

mcl The MetaClass which describes this class. 

subCIs The subclass of this class (or NULL). 

subOffset The offset from the subclass. 

mostSubCIs The root subclass. 

mostSubOffset The offset from the root subclass, 

sublndex The superclass index. 

superClsArray The array of superclass pointers. 

msgArray The array of messages for this class. 

Superclasses 

The class Class is primitive and has no superclasses. 

Messages and Responses 

The class Class is primitive and has no messages. 

Class Variables 

The class Class has no class variables. 
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Function Listing In Alphabetic Order 



Function Name Description Page Scope Macro 



ClsCreate Messages 


Create the Msg instances 


N/A 




Undoc 


N 


ClsCreateObject 


Create a new Object instance 


CIs- 


2 


Public 


N 


ClsCreateSupers 


Create the superclass instances 


N/A 




Undoc 


N 


CIsDeWt 


Deinitialize the instance 


CIs- 


3 


Public 


N 


CIsDestroy 


Deallocate the instance 


as- 


4 


Public 


N 


CIsDestroyMessages - 


Destroy the messages 


N/A 




Undoc 


N 


ClsDestroyObject 


Deallocate the object instance 


as- 


5 


Public 


N 


CIsDestroySuperClasses 


Destroy the superclasses 


N/A 




Undoc 


N 


CIsFindMsg 


Find message given selector name 


CIs- 


7 


Public 


N 


CIsFindSelectorlndex 


Find index of selector given name 


CIs- 


8 


Public 


N 


CIsRndSuperClass 


Find superclass given name 


CIs- 


10 


Public 


N 


CIsGetMessageCount 


Get number of messages 


CIs- 


11 


Public 


N 


CIsGetMethodAndOtfset 


Return method and sub/super offset 


CIs- 


12 


Public 


N 


CIsGetName 


Return name of the instance 


CIs- 


14 


Public 


N 


CIsGetNthMsg 


Get pointer to nth Message 


Cls- 


15 


Public 


N 


CIsGetNthSuperClass 


Get pointer to Nth superclass 


Cls- 


16 


Public 


N 


CIsGetObjectSize 


Return size of an object instance 


as- 


17 


Public 


N 


CIsGetOffsetForMsg 


Return sub/super offset of object 


as- 


18 


Public 


N 


CisGetOffsetOiNthSuper 


Return offset of nth superobject 


as- 


20 


Public 


N 


ClsGetRootSubClass 


Get the root subclass 


CIs- 


22 


Public 


N 


CIsGetRootSubObjectOffset 


Return offset of root subobject 


CIs- 


23 


Public 


N 


CIsGetRootSubObjectSize 


Return size of the root subobject 


as- 


24 


Public 


N 


CIsGetSize 


Return size of the instance 


CIs- 


25 


Public 


N 


CisGetSubClass 


Return subclass 


CIs- 


26 : 


Public 


N 


CIsGetSubObjectOffset 


Return offset of a subobject 


CIs- 


27 


Public 


N 


CIsGetSuperClassCount 


Return number of superclasses 


as- 


28 


Public 


N 


CIsGetSuperClasslndex 


Return superclass index 


as- 


29 


Public 


N 


Clslnit 


Initialize the instance 


as- 


30 


Public 


N 


CIslsRoot 


Is instance the root subclass? 


CIs - 


31 


Public 


N 


CisOffsetSupers 


Offset superclasses from subclass. 


N/A 




Undoc 


N 


ClsPrint 


Print the instance 


CIs - 


32 


Public 


N 


CIsSendDestroy 


Send destroy message to instance 


as- 


33 


Public 


N 


CIsSendObjectMessage 


Send object a message 


CIs- 


34 


Public 


N 


CIsSendObjectMessageReturnlnt 


Send object message, returns Medium Int 


CIs- 


36 


Public 


N 


CIsSendObjectMessageRetumPtr 


Send object message, returns Void * 


Cls- 


38 


Public 


N 


ClsSuperClassOf 


Initialize sub/super relation 


N/A 




Undoc 


N 
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Function Listing By Scope 

Public Functions 



Function Name 


Description 


Page 


Macro 


ClsCreateObject 


Create a new Object instance 


CIS -2 


N 


CisDelnit 


Deinitialize the instance 


CIs -3 


N 


CIsDestroy 


Deallocate the instance 


as-4 


N 


CIsDestroyObject 


Deallocate the object instance 


Cls-5 


N 


CIsFindMsg 


Find message given selector name 


CIs -7 


N 


CIsFindSelectorlndex 


Rnd index of selector given name 


CIs -8 


N 


CIsFindSuperClass 


Find superclass given name 


CIs -10 


N 


CIsGetMessageCount 


Get number of messages 


CIs- 11 


N 


CIsGetMethodAndOffset 


Return method and sub/super offset 


CIs -12 


N 


CIsGetName 


Return name of the instance 


CIs -14 


N 


CIsGetNthMsg 


Get pointer to nth Message 


CIs - 15 


N 


CisGetNthSuperClass 


Get pointer to Nth superclass 


CIs -16 


N 


CIsGetObjectSize 


Return size of an object instance 


as -17 


N 


CIsGetOffsetForMsg 


Return sub/super offset of object 


as -18 


N 


CIsGetOffsetOfNthSuper 


Return offset of nth superobject 


as -20 


N 


CIsGetRootSubClass 


Get the root subclass 


CIS -22 


N 


CIsGetRootSubObjectOffset 


Return offset of root subobject 


CIS -23 


N 


ClsGetRootSubObjectSi2e 


Return size of the root subobiect 


CIS - 24 


N 


CIsGetSize 


Return size of the instance 


CIS -25 


N 


CIsGetSubClass 


Return subclass 


CIS -26 


N 


CIsGetSubObjectOffset 


Return offset of a subobject 


CIS -27 


N 


CIsGetSuperClassCount 


Return number of superclasses 


OS -28 


N 


CIsGetSuperClasslndex 


Return superclass index 


CIS -29 


N 


Clslnit 


Initialize the instance 


OS -30 


N 


CIslsRoot 


Is instance the root subclass? 


CIs -31 


N 


ClsPrint 


Print the instance 


CIS -32 


N 


CIsSendDestroy 


Send destroy message to instance 


OS -33 


N 


CIsSendObjectMessage 


Send object a message 


CIS -34 


N 


CIsSendObjectMessageRetumlnt 


Send object message, returns Mediumlnt 


CIS -36 


N 


CIsSendObjectMessageRetumPtr 


Send object message, returns Void * 


as -38 


N 



Private Functions 



None 
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Und cumented Functi ns 



Function Name 


Description 


Page 


Macro 


CIsCreateMessages 


Create the Msg instances 


N/A 


N 


ClsCreateSupers 


Create the superclass instances 


N/A 


N 


CIsDestroyMessages 


Destroy the messages 


N/A 


N 


CIsDestroySuperCIasses 


Destroy the superclasses 


N/A 


N 


ClsOffsetSupers 


Offset superclasses from subclass. 


N/A 


N 


CIsSuperCIassOf 


Initialize sub/super relation 


N/A 


N 



Friend Functions 



None 









Listing Of Functions by Category 

Undocumented Functions 



Function Name 


Description 


Page 


Scope Macro 


CIsCreateMessages 


Create the Msg instances 


N/A 


Undoc 


N 


ClsCreateSupers 


Create the superclass instances 


N/A 


Undoc 


N 


CIsDestroyMessages 


Destroy the messages 


N/A 


Undoc 


N 


CIsDestroySuperCIasses 


Destroy the superclasses 


N/A 


Undoc 


N 


ClsOffsetSupers 


Offset superclasses from subclass. 


N/A 


Undoc 


N 


CIsSuperCIassOf 


Initialize sub/super relation 


N/A 


Undoc 


N 




Object Functions 








Function Name 


Description 


Page 


Scope Macro 


ClsCreateObject 


Create a new Object instance 


Cls-2 


Public 


N 


CIsDestroyObject 


Deallocate the object instance 


as-5 


Public 


N 


CIsSendObjectMessage 


Send object a message 


Cis-34 


Public 


N 


CIsSendObjectMessageRetumlnt 


Send object message, returns Medium Int 


CIs -36 


Public 


N 


CIsSendObjectMessageRetumPtr 


Send object message, returns Void * 


CIs -38 


Public 


N 



Summary of CIs - 6 



Class 



Initialization Functions 



Function Name 


Description 


Page 


Scope 


Macro 


CIsDelmt 


Deinitialize the instance 


CIS 


-3 


Public 


N 


CIsDestroy 


Deallocate the instance 


CIS 


-4 


Public 


N 


cisimt 


Initialize the instance 


CIS 


OA 

-30 


Public 


N 


CIsSendDestroy 


Send destroy message to instance 


CIs 


•33 


Public 


N 




Query Functions 










Function Name 


Description 


Pag 


e 


Scope Macro 


CIsRndMsg 


Rnd message given selector name 


CIs 


-7 


Public 


N 


CIsRndSelectorlndex 


Rnd index of selector given name 


CIs 


-8 


Public 


N 


CIsRndSuperClass 


Rnd superclass given name 


CIs 


-10 


Public 


N 


CIsGetMessageCount 


Get number of messages 


CIs 


■11 


Public 


N 


CIsGetMethodAndOffset 


Return method and sub/super offset 


CIs 


• 12 


Public 


N 


CIsGetName 


Return name of the instance 


CIs 


•14 


Public 


N 


CIsGetNthMsg 


Get pointer to nth Message 


CIS ■ 


■ 15 


Public 


N 


CIsGetNthSuperClass 


Get pointer to Nth superclass 


CIs- 


■16 


Public 


N 


ClsGetubjectSize 


Return size of an object instance 


as- 


•17 


Public 


N 


CIsGetOffsetForMsg 


Return sub/suDPr of fept of ohiprt 


as- 


18 


Public 


N 


CIsGetOffsetOfNthSuper 


Return offset of nth superobject 


as- 


20 


Public 


N 


CIsGetRootSubClass 


Get the root subclass 


CIs- 


22 


Public 


N 


CIsGetRootSubObjectOffset 


Return offset of root subobject 


CIs- 


23 


Public 


N 


CIsGetRootSubObjectSize 


Return size of the root subobject 


as- 


24 


Public 


N 


CIsGetSize 


Return size of the instance 


CIs- 


25 


Public 


N 


CIsGetSubClass 


Return subclass 


as- 


26 


Public 


N 


ClsGetSubObjectOffset 


Return offset of a subobject 


CIs- 


27 


Public 


N 


CisGetSuperClassCount 


Return number of superclasses 


cis- 


28 


Public 


N 


CIsGetSuperClasslndex 


Return superclass index 


as- 


29 


Public 


N 


CIslsRoot 


Is instance the root subclass? 


CIs- 


31 


Public 


N 



Debug Functions 



Function Name 


Description 


Page 


Scope Macro 


ClsPrint 


Print the instance 


CIs -32 


Public 


N 



Listing Of Functions With Macros Available 



None 
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Class Description for List 



Structure Name: List 

Abbreviation: Dll 

Class Type: Inheritable class 



Introduction 

The List class has a friend class called ListElement. The documentation for the 
List class should therefore be read in conjunction with the ListElement class. 

When sequential mapping is used for ordered lists, achieved using an array 
data structure, operations such as insertion and deletion of arbitrary elements 
become expensive because of the amount of data movement. Linked 
representations of ordered lists are an alternative to sequential 
representations. 

Description 

Unlike a sequential representation where successive items of a list are located 
a fixed distance apart, in a linked representation these items may be placed 
anywhere in memory. Each element points to the next element in the list and 
the previous element in that list. These elements are stored as part of the class 
ListElement. 

Besides the linked items a special node exists called the head node. The head 
node stores the first and last elements in the list. C+O stores the head node as 
part of the class List ListElements also store a pointer to the List they belong to 
(if any). 

It is customary to draw linked lists as an ordered sequence of nodes with links 
being represented by arrows. Figure 1 shows a sample doubly linked list with 4 
nodes [ListElements] A, B, C and D. The head node (List) points to nodes A and 
D. 

Head node 



Figure 1 
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List 



The Ust class is the data structure representation of the head node. The 
ListEHement class is the data structure representation of a single element in a 
doubly linked list. 

Glossary and Special Terms 

Figure 2 shows the first and last element in a doubly linked list. Because each 
list element stores a pointer to the List class ( head node ) the first and last 
elements are also accessible from each element. 

The size of a list is the number of elements in that list. 

To get from the first element to the last element you would access successor, 
or next elements. To get from the last element to the first element you would 
access predecessor or previous elements. 

The predecessor of the first element is NULL. The successor to the last element 
is NULL. All other elements will have non-NULL predecessors and successors. 
There exists only zero or one predecessor for a given element. 




Figure 2 



A range of list elements is defined as a beginning list element and an ending 
list element. 

Examples of a valid range of list elements: 

1) A through H, here the range is from first to last. 2) C through E, here the 
range spans elements C, D and E. 3) F through F, here the range spans one 
element, F. 
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List 



Examples of an invalid range of list elements: 

1) E through A, here the range is backwards. 2) A through I, here the range 
spans outside the list. 

The size of a List is the number of elements it contains. Figure 3 shows a 
doubly linked list with size 8. 




Figure 3 
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Class Implementation List 

Instance Variables 

The following is the data structure definition for a doubly linked list. 



struct List{ Object obj; 

Medium Int dllCheck; 

PLEL first; 

PLEL last; } 



obj Gives List class object-oriented properties of inheritance and 

dynamic binding. 
dllCheck Uniquely identifies List instances, 

first First element in list, 

last Last element in list. 

Messages and Responses 

The implementation of the destroy message is handled by DllDestroy however 
subclasses should override this message. The destroy message is not used by 
any methods of Dll. 



Selector Method Description 

destroy DllDestroy Destroy the object 

Class Variables 

Type Name Description 

Mcl DIIMcl Metaclass description for List 
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Function Listing In Alphabetic Order 



Function Name 


Description 


Page 


Scope Macro 


DIIAppend 


Append element to list 


DII-2 


Public 


N 


DIIAppendLast 


Make element last 


DII-4 


Public 


Y 


DIIAsObj 


Return list as object 


01 -6 


Private 


Y 


DHCIear 


Clear the list 


DII-7 


Public 


N 


DliCut 


Cut one element from list 


DII-8 


Public 


N 


DliCutChildren 


Cut all elements from list 


DII-10 


Public 


N 


DIICutRange 


Cut element(s) from list 


DII-11 


Public 


N 


DIIDelnit 


Deinitialize list object 


on - 13 


Public 


N 


DIIDestroy 


Deinitialize list object and free space 


DM - 14 


Public 


N 


DIIGetClient 


Return client of list 


011-15 


Public 


Y 


DIIGetFirst 


Return first element 


011-16 


Private 


Y 


DIIGetUst 


Return last element 


Dll - 17 


Private 


Y 


DHGetNth 


Return Nth element 


Dll - 18 


Private 


N 


DUGetS'ize 


Get size of list 


Dll • 19 


Public 


N 


Dlllnit 


Initialize list object 


Oil -20 


Public 


N 


Dlllnsert 


Insert element in list 


Dll -21 


rv ,ui:* 

Public 


N 


DlllnsertRrst 


Make element first 


011-23 


Public 


w 

Y 


DlllsEmpty 


Return True if list empty 


DU -25 


Public 


Y 


DIILelClientCount 


Visit function: count elements conditionally 


Dll -26 


Public 


N 


DIILeiCltentFind 


Visit search function: all elements 


DII-28 


Public 


N 


DliLelClientFirst 


Return client of first element 


Dll -30 


Public 


Y 


Hill AlPlipntnptNlth 


Rpti im Nth riipnt 
riciuiii iviii wild 11 


Dll -31 


Public 


N 


DIlLelCIientLast 


Return client of last element 


Dll -33 


Public 


Y 


DIILelClientVisitBwd 


Visit function: all elements 


Dll -34 


Public 


N 


DIILelClientVisitFwd 


Visit function: all elements 


011-36 


Public 


N 


DIINotifyCutRange 


Cut elements 


011-38 


Friend 


N 


DIINotifyPasteRange 


Paste elements 


Dll -39 


Friend 


N 


DIIPasteRangeAfler 


Paste elements) to list 


Dll -40 


Public 


N 


DIIPasteRangeBefbre 


Paste elements) in list 


Dll -42 


Public 


N 


DIIPasteRangeRrst 


Paste element(s) to be first in list 


Dll -44 


Public 


Y 


DHPasteRangeLast 


Paste element(s) to end of list 


011-46 


Public 


Y 


DIISendDestroy 


Send message for list destruction 


Dll - 46 


Public 


N 
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Function Listing By Scope 

Public Functions 



Eiirtpffnn Mama 

runcuun name 


uescnpuQii 


Dana 
rage 


lYldCTQ 


nil Anno nH 


nppeiKj element to usi 


nil . o 

UII * c 


M 
IN 


nil A iinflnWI qef 

uiiAppenaLasi 


MaKe element lasi 


nil a 
mi - h 


M 
IN 


unclear 


uear tne list 


mi - / 


Kl 


UllCUt 


Cut one element from Gst 


nn o 


Kl 

In 


nil it^klMmn 

uiicutcniidren 


Cut all elements from list 


□II - 10 


N 


uucutHange 


Cut eiement(s) from list 


mi a a 
UII - 1 1 


Kl 

IN 


uii ue in It 


Deinitialize list object 


nn <o 
UII - 13 


Kl 

N 


un Destroy 


ueiniuaiize list opject ana tree space 


nn a a 
UII - 14 


Kl 

IN | 


nilflotPliont 

uuueioneni 


Doti im aIi Ant /\f fid 

neturn client or list 


nj| 1 c 
UN * 10 


M 
IN 


uiiueioize 


oei size ot list 


nn iq 
uii - iy 


Kl 
IN 


uiiinit 


initialize ust ouject 


mi on 
UII - c\) 


N 


uu insert 


insen eiemeni in usi 


mi 01 
UII * c 1 


Kl 
IN 


DlllnsertFirst 


Make element first 


Dll -23 


N 


DlllsEmpty 


Return True if list empty 


DII-25 


N 


DHLelClientCount 


Visit function: count elements conditionally 


CHI -26 


N 


DIILelClientFind 


Visit search function: all elements 


Dll -28 


N 


DHLelClientFirst 


Return client of first element 


Dll -30 


N 


DIILelClientGetNth 


Return Nth client 


Dll -31 


N 


DIILelClientLast 


Return client of last element 


Dll -33 


N 


Dill piniipntVtttRwri 


Vicit fiinrhYin* all olompntc 
viou luifcuvii. oil ciciiiciiio 




N 


Hill olPliontV/ieitPuuH 


V/tcit fi trv*H/MT 4(1 aI Am Ante 

visit function, ail elements 


UII - 00 


Kl 
IN 


uiirasienangeMiter 


rasie eiement(S; to usi 


UII - w 


Kl 
IN 


DIIPasteRangeBefore 


Paste elements) in list 


Dll -42 


N 


DHPasteRangeRrst 


Paste elements) to be first in list 


Dll -44 


N 


DIIPasteRangeLast 


Paste elements) to end of list 


Dll -46 


N 


DIISendDestroy 


Send message for list destruction 


Dll -48 


N 




Private Functions 






Function Name 


Description 


Page 


Macro 


DIIAsObj 


Return list as object 


Dll -6 


N 


DliGetRrst 


Return first element 


Dll - 16 


N 


DIIGetLast 


Return last element 


Dll - 17 


N 


DIIGetNth 


Return Nth element 


Dll • 18 


N 



Undocumented Functions 



None 
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Friend Functions 



Function Name 


Description 


Page 


Macro 


DIINotifyCutRange 


Cut elements 


DII-38 


N 


DIlNotifyPasteRange 


Paste elements 


Dil-39 


N 



Listing Of Functions by Category 

Edit Functions 



Function Name 


Description 


Paae 


Scope Macro 


Dll Append 


Append element to list 


DH-2 


Public 


N 


DIIAppendLast 


Make element last 


Dil -4 


Public 


Y 


DHCiear 


Clear the list 


Oil - 7 


Public 


N 


DllCut 


Cut one element from list 


DII-8 


Public 


N 


DllCutChildren 


Cut all elements from list 


DII-10 


Public 


N 


DIICutRange 


Cut element(s) from list 


Oil - 1 1 


Public 


N 


Dlllnsert 


Insert element in list 


DH -21 


Public 


N 


DllinsertFirst 


Make element first 


Oil -23 


Public 


Y 


DIINotifyCutRange 


Cut elements 


DII-38 


Friend 


N 


DIlNotifyPasteRange 


Paste elements 


Oil -39 


Friend 


N 


DIIPasteRangeAtter 


Paste element(s) to list 


Oil -40 


Public 


N 


DIIPasteRangeBefore 


Paste elements) in list 


Oil -42 


Public 


N 


DIIPasteRangeRrst 


Paste elements) to be first in list 


DII-44 


Public 


Y 


DIIPasteRangeLast 


Paste element(s) to end of list 


DII-46 


Public 


Y 


Superclass Functions 








Function Name 


Description 


Page 


Scope Macro 


DIIAsObj 


Return list as object 


DII-6 


Private 


Y 



Initialization Functions 



Function Name 


Description 


Pa; 


je 


Scope Macro 


DIIDelnit 


Deinitialize list object 


Oil 


-13 


Public 


N 


DIIDestroy 


Deinitialize list object and free space 


Dll 


-14 


Public 


N 


Olllnit 


Initialize list object 


CHI 


-20 


Public 


N 


DUSendDestroy 


Send message for list destruction 


Dll 


•48 


Public 


N 
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Query Functi ns 



Function Name 


Description 


Page 


Scope Macro 


DIIGetCKent 


Return client of list 


DII-15 


Public 


Y 


DIIGetFirst 


Return first element 


DII-16 


Private 


Y 


DDGetLast 


Rpturn last plpmpnt 


nil - 1 7 


Private 


Y 


DIIGetNth 


Return Nth element 


DO -18 


Private 


N 


DHGetSize 


Get size of list 


Dll • 19 


Public 


N 


DilisEmpty 


Return True if list empty 


DII-25 


Public 


Y 


DllLelClientCount 


Visit function: count elements conditionally 


011-26 


Public 


N 


DIlLelClientRnd 


Visit search function' all elements 

vlwll MVGUwII iUI IWUWI it wUI Vlwl Mwl 1 UJ 


Dll - 28 


Public 


N 


DOLelClientRrst 


Return client of first element 


011-30 


Public 


Y 


DIILelClientGetNth 


Return Nth client 


CHI -31 


Public 


N 


DIILelClientLast 


Return client of last element 


Dll - 33 


Public 


Y 




Visit Functions 








Function Name 


Description 


Page 


Scope Macro 


DIILelClientVisitBwd 


Visit function: all elements 


Dll -34 


Public 


N 


DHLelCtientVisitFwd 


Visit function: all elements 


Dll -36 


Public 


N 


Listing Of Functions With Macros Available 








Function Name 


Description 


Page 


Scope 




DIIAppendLast 


Make element last 


Dll -4 


Public 




DHAsObj 


Return list as object 


Dll -6 


Private 




DIIGetCKent 


Return client of list 


DII-15 


Public 




DIIGetRrst 


Return first element 


DII-16 


Private 




DIIGetLast 


Return last element 


Dll -17 


Private • 




DlllnsertFirst 


Make element first 


Dll -23 


Public 




DilisEmpty 


Return True if list empty 


DII-25 


Public 




DIILelClientFirst 


Return client of first element 


Dll -30 


Public 




DIILelClientUst 


Return client of last element 


Dll -33 


Public 




DIIPasteRangeRrst 


Paste elements) to be first in list 


Dll -44 


Public 




DIIPasteRangeLast 


Paste element(s) to end of list 


Dll -46 


Public 
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Class Description for DynamicArray 



Structure Name: DynamicArray 
Abbreviation: Dpa 
Class Type: Primitive 



Introduction 

The DynamicArray is a class for structuring data as an array of pointers such 
that elements can be quickly accessed by an index. The array in this case is 
dynamic, since it can grow and shrink at will. The next version of C+O will 
change the name DynamicArray to DynamicPointerArray. Please refer to the 
DynamicArray as Dpa when writing a program. 

Applications of DynamicArray include graphical object arrays, text editor line 
display lists, stacks, queues, etc. 

Because DynamicArray is a primitive class, it cannot inherit nor can it be 
inherited. A future version of C+O may change that. 

Description 

An array is a set of pairs, index and value. For each index which is defined, 
there is a value associated with that index. This is known as a mapping. The 
values in the DynamicArray class are 16 bit or 32 bit pointers (depending on 
memory model). Figure 1 shows an array of 6 elements with values A, B, C, D, 
E and F. The first element in the array A is at index zero. 




Figure 1 
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While elements of the array are not required to point to objects of the same 
class, DynamicArray Is more valuable if they do. No loss of generality is 
encountered by doing this since the array element may point to a common 
abstract object type. Individual objects can then be of any subclass of the 
abstract type. (See section on classes for more details.) 

While the array of elements may grow or shrink, the location of a 
DynamicArray object never changes. The array is grown or shrunk in multiples 
of a user specified value, thus changing the logical size of the array does not 
always result in a resizing of the physical array. 

Glossary and Special Terms 

The number of elements in an array is the size of the array. Figure 2 shows an 
array with 4 elements A, B, C and D. The size of the array is therefore 4. 




DIBIHID 



Figure 2 



A range of array elements is defined as a beginning element and an ending 

element. Figure 3 shows an array with size 8. Possible valid ranges of 
elements are: 

1) 0 through 7, here the range spans A, B, C, D, E, F, G, H. 2) 2 through 4, 
here the range spans elements C, D and E. 3) 5 through 5, here the range 
spans one element, F. 

Possible invalid ranges of list elements are: 

1) 4 through 0, here the range is backwards. 2) 0 through 8, here the range 
spans outside the array. 




Figure 3 
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A regi n of array elements is defined as a beginning element and a c lint from 
the beginning element. Figure 4 shows an array with size 8. Possible valid 
regions of array elements are: 

1) A with count 8, here the region is from first to last. 2) C with count 3, here 
the region spans elements C, D and E. 3) F with count 1, here the range spans 
one element, F. 

Possible invalid regions of list elements are: 

1) E with count 0, here the number of elements is less than 1. 2) C with count 
9, here the count spans outside the array. 



niDlHlDlDlDlBi 



Figure 4 
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Class Implementation DynamicArray 



Instance Variables 

The following is the data structure definition for an array. 

struct DynamicArray { Medium I nt dpaCheck; 

ClientPtr 'array; 

Mediumlnt size; 

Mediumlnt allocSize; 

Mediumlnt increment; } 

dllCheck Uniquely identifies List instances, 

array Holds the array values, 

size Logical size of array. 

allocSize Allocated size of array, 

increment Amount to grow the array by. 

Superclasses 

The DynamicArray class does not inherit from any other classes. 

Class Variables 

The DynamicArray class has no class instance variables. 
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Function Listing In Alphabetic Order 



Function Name Description Page Scope Macro 



DpaAppend 


Append an element 


Dpa 


-2 


Public 


N 


DpaCiear 


Clear dynamic array 


Dpa 


•4 


Public 


N 


DpaCount 


Visit function: count True returns 


Dpa 


•5 


Public 


N 


DpaCountRange 


Visit function: range with return checking 


Dpa 


-7 


Public 


N 


DpaDelnit 


Deinitialize the dynamic array object 


Dpa 


-9 


Public 


N • 


DpaDelete 


Delete element(s) 


Dpa 


-10 


Public 


N 


DpaDestroy 


Deinitialize array object and free space 


Dpa 


•12 


Public 


N 


DpaExpand 


Paste Null elements) into array 


Dpa 


-13 


Public 


N 


DpaRnd 


Rnd index returning True 


Dpa 


•15 


Public 


N 


DpaRndPtrBwd 


Rnd index with matching pointer 


Dpa 


-17 


Public 


N 


DpaFindPtrFwd 


Rnd index with matching pointer 


Dpa 


•19 


Public 


N 


DpaRndRangeBwd 


Rnd index returning True for range 


Dpa 


•21 


Public 


N 


DpaRndRangeFwd 


Rnd index returning True for range 


Dpa- 


•23 


Public 


N 


DpaGetLast 


Return last element in array 


Dpa- 


•27 


Public 


N 


DpaGetNth 


Return Nth array element 


Dpa- 


■25 


Public 


N 


DpaGetSize 


Return number of elements 


Dpa- 


29 


Public 


N 


Dpalnit 


Initialize the edge object 


Doa - 


■31 


Public 


N 


DpaNewArray 


Create a new array 


N/A 




Undoc 


N 


DpaResize 


Resize the array 


N/A 




Undoc 


N 


DpaSetNth 


Set Nth element of array 


Dpa- 


33 


Public 


N 


OpaSetRegionNull 


Make region of elements Null 


Dpa- 


35 


Public 


N 


OpaSetSize 


Set array size to N elements 


Dpa ■ 


37 


Public 


N 


DpaShiftDown 


Shift down N elements in array 


Dpa- 


38 


Public 


N 


DpaShiftUp 


Shift up N elements in array 


Dpa- 


40 


Public 


N 


Dpa Visit 


Visit function: all elements 


Dpa- 


42 


Public 


N 


DpaVisitClient 


Visit function: all elements 


Dpa- 


44 


Public 


N 


DpaVisitRange 


Visit function: range of elements 


Dpa - 


46 


Public 


N 


OpaVisitRegion 


Visit function: region of elements 


Dpa- 


48 


Public 


N 


DpaVisitSelfAndSuccessors 


Visit function: client and successors 


Dpa- 


50 


Public 


N 
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Function Listing By Scope 

Public Functions 



Function Name 


Description 


Page 


Macro 


OpaAppend 


Append an element 


Dpa -2 


N 


DpaCIear 


Clear dynamic array 


Dpa -4 


N 


DpaCount 


Visit function: count True returns 


Dpa -5 


N 


DpaCountRange 


Visit function: range with return checking 


Dpa -7 


N 


DpaDelnit 


Deinitialize the dynamic array object 


Dpa -9 


N 


DpaDelete 


Delete elements) 


Dpa -10 


N 


DpaDestroy 


Deinitialize array object and free space 


Dpa -12 


N 


DpaExpand 


Paste Null elements) into array 


Dpa -13 


N 


DpaRnd 


Rnd index returning True 


Dpa -15 


N 


DpaRndPtrBwd 


Rnd index with matching pointer 


Dpa- 17 


N 


DpaRndPtrFwd 


Rnd index with matching pointer 


Dpa -19 


N 


DpaFindRangeBwd 


Rnd index returning True for range 


Dpa -21 


N 


DpaRndRangeFwd 


Rnd index returning True for range 


Dpa - 23 


N 


DpaGetLast 


Return last element in array 


Dpa -27 


N 


DpaGetNth 


Return Nth array element 


Dpa -25 


N 


DpaGetSize 


Return number of elements 


Dpa -29 


N 


Dpalnit 


Initialize the edge object 


Dpa-31 


N 


DpaSetNth 


Set Nth element of array 


Dpa-33 


N 


DpaSetRegionNull 


Make region of elements Null 


Dpa-35 


N 


DpaSetSize 


Set array size to N elements 


Dpa -37 


N 


DpaShiftDown 


Shift down N elements in array 


Dpa-38 


N 


DpaShiftUp 


Shift up N elements in array 


Dpa -40 


N 


Dpa Visit 


Visit function: all elements 


Dpa-42 


N 


DpaVisitCtient 


Visit function: all elements 


Dpa -44 


N 


DpaVisitRange 


Visit function: range of elements 


Dpa-46 


N 


DpaVisitRegion 


Visit function: region of elements 


Dpa-48 


N 


DpaVisitSelfAndSuccessors 


Visit function: client and successors 


Dpa -50 


N 


Private Functions 


None 








Undocumented Functions 






Function Name 


Description 


Page 


Macro 


DpaNewArray 


Create a new array 


N/A 


N 


DpaResize 


Resize the array 


N/A 


N 
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Friend Functions 



None 









Listing Of Functions by Category 

Edit Functions 



Function Name 


Description 


Page 


Scope Macro 


OpaAppend 


Append an element 


Dpa-2 


Public 


N 


DpaClear 


Clear dynamic array 


Dpa-4 


Public 


N 


DpaDelete 


Delete elements) 


Dpa-10 


Public 


N 


D6*Expand 


Paste Null element(s) into array 


Dpa-13 


Public 


N 


DpaNewArray 


Create a new array 


N/A 


Undoc 


N 


DpaResize 


Resize the array 


N/A 


Undoc 


N 


DpaSetNth 


Set Nth element of array 


Dpa-33P 


Jblic 


N 


DpaSetRegionNull 


Make region of elements Null 


Dpa-35 


Public 


N 


DpaSetSize 


Set array size to N elements 


Dpa-37 


Public 


N 


DpaShiftDown 


Shift down N elements in array 


Dpa-38 


Public 


N 


DpaShiftUp 


Shift up N elements in array 


Dpa-40 


Public 


N 




Query Functions 








Function Name 


Description 


Page 


Scope Macro 



DpaCount 


Visit function: count True returns 


Dpa< 


•5 


Public 


N 


DpaCountRange 


Visit function: range with return checking 


Dpa- 


7 


Public 


N 


DpaRnd 


Rnd index returning True 


Dpa- 


15 


Public 


N 


DpaRndPtrBwd 


Rnd index with matching pointer 


Dpa« 


17 


Public - 


N 


DpaRndPtrFwd 


Rnd index with matching pointer 


Dpa- 


19 


Public 


N 


DpaRndRangeBwd 


Rnd index returning True for range 


Dpa- 


21 


Public 


N 


DpaRndRangeFwd 


Rnd index returning True for range 


Dpa- 


23 


Public 


N 


DpaGetLast 


Return last element in array 


Dpa- 


27 


Public 


N 


DpaGetNth 


Return Nth array element 


Dpa- 


25 


Public 


N 


DpaGetSize 


Return number of elements 


Dpa- 


29 


Public 


N 
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Initializati n Functions 



Function Name Description Page Scope Macro 



DpaDelnit 


Deinitialize the dynamic array object 


Dpa-9 


Public 


N 


DpaDestroy 


Deinitialize array object and free space 


Dpa -12 


Public 


N 


Dpalnit 


Initialize the edge object 


Dpa-31 


Public 


N 




Visit Functions 








Function Name 


Description 


Page 


Scope Macro 


Dpa Visit 


Visit function: all elements 


Dpa -42 


Public 


N 


DpaVisitCIient 


Visit function: all elements 


Dpa-44 


Public 


N 


DpaVisitRange 


Visit function: range of elements 


Dpa-46 


Public 


N 


DpaVisitRegion 


Visit function: region of elements 


Dpa-48 


Public 


N 


DpaVisitSelfAndSuccessors 


Visit function: client and successors 


Dpa -50 


Public 


N 



Listing Of Functions With Macros Available 



None 
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Class Description for Edge 



Structure Name: 



Edge 
Edg 

Inheritable class 



Abbreviation: 



Class Type: 



Introduction 

An Edge is a only a useful object In the context of a graph and vertices. Edges 
can be subclassed to represent for example, relationships between activities in 
a critical path application, interdependencies between cells in a spreadsheet, 
links in a hypertext document, etc. 

The Edge class has two friend classes Vertex and Graph. The documentation for 
the Edge class should therefore be read in conjunction with the classes Vertex 
and Graph. 

Description 

An edge connects two vertices. An edge has a tail and a head. The vertex 
connected to the tail is the incoming vertex and the vertex connected to the 
head is the outgoing vertex. In an undirected graph, these distinctions are 
meaningless. In Figure 1 below the edge x has the outgoing vertex A and the 
incoming vertex B. 



Outgoing 
Vertex 




Figure 1 
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Glossary and Special Terms 

The predecessor vertex of an edge is its incoming vertex and the successor 

vertex is its outgoing vertex. Similarly, the successor vertices of a Vertex A are 
the vertices at the head of the outgoing edges of A. The predecessor vertices of 
A are the vertices at the tail end of the incoming edges of A. See Figure 2. 



Class Implementation Edge 

Instance Variables 

The following is the data structure definition for a edge in a directed graph. 




Outgoing Edge 



Figure 2 



struct Edge { 



Obj obj; 

Mediumlnt edgCheck; 

Lei grfLel; 

Lei inLel; 

Lei outLel; }; 




obj 



outLel 



Gives Edge class object-oriented properties of inheritance 

and dynamic binding. 

Uniquely identifies Edge instances. 

List element in a graph. 

List element of incoming edges for a vertex. 

List element of outgoing edges for a vertex. 



Superclasses 
Type 



Name 



Description 



ListElement GrfLel 
ListElement InLel 
ListElement OutLel 



Connects edge to graph 
Connects edge to incoming vertex 
Connects edge to outgoing vertex 



Messages and Responses 
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Messages and Responses 

Edge overrides the destroy message from all three of its ListElement 
iperclasses. The implementation of the destroy message is handled b 
IgDestroy. Subclasses of Edge should override the destroy message. 



Selector Method 

destroy Edg Destroy 

Class Variables 



Type 

Mcl 

Medigm Int 
Mediumlnt 
Mediumlnt 



Name 
EdgMcl 

EdgGrfLelOffset 

EdglnLelOffset 

EdgOutLelOffset 



Description 

Destroy the object 

Description 



Metaclass decription for Edge. 
of Ec 

GrfLel 



Client offset of Edge from superclass 



Client offset of Edge from superclass 
InLel 

Client offset of Edge from superclass 
OutLel 
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Function Listing In Alphabetic Order 



Function Name Description Page Scope Macro 



EdgAsGrfLel 


Return graph list element for edge 


Edg-2 


Friend 


Y 


EdgAslnLel 


Return incoming edge list element 


Edg-3 


Friend 


Y 


EdgAsObj 


Return edge as object 


Edg-4 


Private 


N 


EdgAsOutLel 


Return outgoing edge list element 


Edg-5 


Friend 


Y 


EdgClear 


Clear the edge 


Edg-6 


Public 


N 


EdgComparelnVtx 


Compare incoming vertex 


Edg-7 


Public 


N 


EdgConnectToGrf 


Connect edge to graph 


Edg -9 


Public 


Y 


EdgConnectToVertices 


Connect edge to vertices 


Edg-11 


Public 


N 


EdgDelnit 


Deinitialize the edge object 


Edg-13 


Public 


N 


EdgDestroy 


Deinitialize edge object and free space 


Edg-14 


Public 


N 


EdgDisconnectFromGrf 


Disconnect edge from graph 


Edg - 15 


Public 


Y 


EdgDisconnectFromVertices 


Disconnect edge from vertices 


Edg -17 


Public 


N 


EdaGetClient 


Return client of edne 


Eda - 19 


Public 


v 

I 


EdgGetGrf 


Return graph 


Edg -20 


Friend 


Y 


EdgGetlnVtx 


Return incoming vertex 


Edg -21 


Friend 


Y 


EdgGetNextln 


Return next incoming edge 


Edg -23 


Friend 


Y 


EdgGetNextOut 


Return next outgoing edge 


Edg -25 


Friend 


Y 


EdgGetOutVtx 


Return outgoing vertex 


Edg -27 


Friend 


Y 


EdgGetVertices 


Return vertices to edge 


Edg -29 


Public 


Y 


EdgHasVertices 


Does edge have any vertices 


Edg -31 


Public 


N 


EdginGrf 


Is edge in graph 


Edg -32 


Public 


Y 


Edglnit 


Initialize the edge object 


Edg -33 


Public 


N 


EdgSendDestroy 


Send message for edge destruction 


Edg -34 


Public 


Y 


EdgUpdateinVtx 


Replace incoming vertex 


Edg -35 


Public 


N 


EdgUpdateOutVlx 


Replace outgoing vertex 


Edg -37 


Public 


N 
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Function Listing By Scope 

Public Functions 



Function Name 


Description 


Page 


Macro 


EdgClear 


Clear the edge 


Edg-6 


N 


EdgComparelnVtx 


Compare incoming vertex 


Edg-7 


N 


EdgConnectToGrf 


Connect edge to graph 


Edg-9 


N 


EdgConnectToVertices 


Connect edge to vertices 


Edg-11 


N 


EdgDelnit 


Deinitiaiize the edge object 


Edg-13 


N 


EdgDestroy 


Deinitialize edge object and free space 


Edg-14 


N 


EdgDisconnectFromGrf 


Disconnect edge from graph 


Edg-15 


N 


EdgDisconnectFromVertices 


Disconnect edge from vertices 


Edg-17 


N 


EdgGetClient 


Return client of edge 


Edg-19 


N 


EdgGetVertices 


Return vertices to edge 


Edg-29 


N 


EdgHasVertices 


Does edge have any vertices 


Edg-31 


N 


EdglnGrf 


Is edge in graph 


Edg-32 


N 


Edglnit 


Initialize the edge object 


Edg-33 


N 


EdgSendDestroy 


Send message for edge destruction 


Edg-34 


N 


EdgUpdatelnVtx 


Replace incoming vertex 


Edg-35 


N 


EdgUpdateOutVtx 


Replace outgoing vertex 


Edg-37 


N 




Private Functions 






Function Name 


Description 


Page 


Macro 


EdgAsObj 


Return edge as object 


Edg-4 


N 



Undocumented Functions 



None 
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Friend Functions 



Function Name 


Description 


Page 


Macro 


EdgAsGrfLel 


Return graph list element for edge 


Edg-2 


N 


EdgAslnLel 


Return incoming edge list element 


Edg-3 


N 


EdgAsOutLel 


Return outgoing edge list element 


Edg-5 


N 


EdgGetGrf 


Return graph 


Edg-20 


N 


EdgGetlnVtx 


Return incoming vertex 


Edg-21 


N 


EdgGetNextln 


Return next incoming edge 


Edg-23 


N 


EdgGetNextOut 


Return next outgoing edge 


Edg-25 


N 


EdgGetOulVtx 


Return outgoing vertex 


Edg-27 


N 



Listing Of Functions by Category 

Superclass Functions 



Function Name 


Description 


Page 


Scope Macro 


EdgAsGrfLel 


Return graph list element for edge 


Edg-2 


Friend 


Y 


EdgAslnLel 


Return incoming edge list element 


Edg-3 


Friend 


Y 


EdgAsObj 


Return edge as object 


Edg-4 


Private 


N 


EdgAsOutLel 


Return outgoing edge list element 


Edg-5 


Friend 


Y 




Edit Functions 








Function Name 


Description 


Page 


Scope Macro 


EdgQear 


Clear the edge 


Edg-6 


Public 


N 


EdgConnectToGrf 


Connect edge to graph 


Edg-9 


Public 


Y 


EdgConnectToVertices 


Connect edge to vertices 


Edg-11 


Public 


N 


EdgDisconnectFromGrf 


Disconnect edge from graph 


Edg-15 


Public 


Y 


EdgDisconnectFromVertices 


Disconnect edge from vertices 


Edg-17 


Public 


N 


EdgUpdatelnVtx 


Replace incoming vertex 


Edg-35 


Public 


N 


EdgUpdateOutVtx 


Replace outgoing vertex 


Edg-37 


Public 


N 
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Query Functions 



Function Name 


Description 


Page 


Scope Macro 


EdgComparelnVtx 


Compare incoming vertex 


Edg-7 


Public 


N 


EdgGetClient 


Return client of edge 


Edg-19 


Public 


Y 


EdgGetGrf 


Return graph 


Edg-20 


Friend 


Y 


EdgGetlnVtx 


Return incoming vertex 


Edg-21 


Friend 


Y 


EdgGetNextln 


Return next incoming edge 


Edg-23 


Friend 


Y 


EdgGetNextOut 


Return next outgoing edge 


Edg-25 


Friend 


Y 


EdgGetOutVtx 


Return outgoing vertex 


Edg-27 


Friend 


Y 


EdgGetVertices 


Return vertices to edge 


Edg-29 


Public 


Y 


EdgHasVertices 


Ooes edge have any vertices 


Edg-31 


Public 


N 


EdglnGrf 


Is edge in graph 


Edg-32 


Public 


Y 



Initialization Functions 



Function Name 


Description 


Page 


Scope Macro 


EdgDelnit 


Deinitialize the edge object 


Edg-13 


Public 


N 


EdgDestroy 


Deinitialize edge object and free space 


Edg-14 


Public 


N 


Edglnit 


Initialize the edge object 


Edg«33 


Public 


N 


EdgSendDestroy 


Send message for edge destruction 


Edg-34 


Public 


Y 


Listing Of Functions With Macros Available 








Function Name 


Description 


Page 


Scope 




EdgAsGrfLel 


Return graph list element for edge 


Edg-2 


Friend 




EdgAslnLel 


Return incoming edge list element 


Edg-3 


Friend 




EdgAsOutLel 


Return outgoing edge list element 


Edg-5 


Friend 




EdgConnectToGrf 


Connect edge to graph 


Edg-9 


Public 




EdgDisconnectFromGrf 


Disconnect edge from graph 


Edg-15 


Public 




EdgGetClient 


Return client of edge 


Edg-19 


Public 




EdgGetGrf 


Return graph 


Edg-20 


Friend 




EdgGetlnVtx 


Return incoming vertex 


Edg-21 


Friend 




EdgGetNextln 


Return next incoming edge 


Edg-23 


Friend 




EdgGetNextOut 


Return next outgoing edge 


Edg-25 


Friend 




EdgGetOutVtx 


Return outgoing vertex 


Edg-27 


Friend 




EdgGetVertices 


Return vertices to edge 


Edg-29 


Public 




EdglnGrf 


Is edge in graph 


Edg-32 


Public 




EdgSendDestroy 


Send message for edge destruction 


Edg-34 


Public 





Summary of Edg - 7 



I 

Edge g 

I 
I 
I 

l 
I 

i 

I 
I 

This page intentionally left blank 

1 
1 
I 
I 
1 
i 
I 
I 

Summary of Edg - 8 



Class Description for Graph 



Structure Name: 



Graph 
Grf 



Abbreviation: 



Class Type: 



Inheritable class 



introduction 

Graphs are used for a variety of applications. Some of these applications are: 
analysis of electrical circuits, finding shortest routes, analysis of project 
planning, identification of chemical compounds, statistical mechanics, 
genetics, cybernetics, CASE tools, etc. Of all mathematical structures, graphs 
are the most widely used. 

The Graph class has two friend classes Vertex and Edge. The documentation for 
the Graph class should therefore be read in conjunction with the classes Vertex 
and Edge. 

Description 

A graph consists of a set of vertices and a set of edges, where each edge is a 
pair of distinct vertices. 

Graph can deal with directed graphs or digraphs. In a directed graph each 
edge is represented by a directed pair of vertices, and the edges are drawn with 
an arrow from the tail to the head. A graph can have multiple occurances of the 
same edge (i.e. two edges with identical predecessor and successor vertices), it 
is up to the client of Graph to determine whether this should be allowed. In 
Figure 1 below the graph G contains the vertices A, B, C, D, and the edges a, b, 
c, d, e, f. 




Graph G 



Figure 1 
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Glossary and Special Terms 

A vertex can have incoming edges and outgoing edges. In Figure 2 below the 
vertex A has an incoming edge x, and an outgoing edge y. 



Incoming Edge 




An edge connects two vertices. An edge has a tail and a head. The vertex 
connected to the tail is the incoming vertex and the vertex connected to the 
head is the outgoing vertex. In an undirected graph, these distinctions are 
meaningless. In Figure 3 below the edge x has the outgoing vertex A and the 
incoming vertex B. 

The predecessor vertex of an edge is its incoming vertex and the successor 

vertex is its outgoing vertex. Similarly, the successor vertices of a Vertex A are 
the vertices at the head of the outgoing edges of A. The predecessor vertices of 
A are the vertices at the tail end of the incoming edges of A See Figure 3. 



Outgoing y /*->v Incomii 

Vertex (V)- (V) Vertex 



Figure 3 



A graph without cycles is acyclic. A cycle is a path of edges that return back 
to the starting point. In Figure 4 below the graph G, which has vertices A B, C. 
and edges x, y, z, has a cycle and is, therefore, not acyclic. 




Figure 4 
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Class Implementation Graph 



Instance Variables 

The following is the data structure definition for a directed graph. 



struct Graph { 



Obj 

Mediumlnt 

Dll 

Dll 

Dpa 

Dpa 



obj; 

grfCheck; 
vtxList; 
edgList; 
forwardSort; 
backwardSort; } 



obi 

grfCheck 

vtxList 

edgList 

forwardSort 

backwardSort 

Superclasses 
Type 

List 
List 



Allows Graph to inherit and be inherited. 
Uniquely identifies Graph instances. 
List of Vertices. 
List of Edges. 

Array storing vertices in forward topological order. 
Array storing vertices in backward topological order. 



Name 

VtxDII 
EdgDII 



Description 

List of vertices 
List of edges 



Messages and Responses 



Graph overrides the destroy message from both of its List superclasses. The 
implementation of the destroy message is handled by GrfDestroy. The subclass 
should override this message. 



Selector Method 

destroy GrfDestroy 

Class Variables 



Type 
Mcl 

Mediumlnt 



Name 

GrfMcl 

GrfVtxDIIOffset 



Mediumlnt GrfEdgDIIOffset 



Description 
Destroy the object 

Description 

Metaclass decription for Graph. 
Client offset of Graph from superclass 
VtxDII 

Client offset of Graph from superclass 
EdgDII 
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Function Listing in Alphabetic Order 



Function Name Description Page Scope Macro 



GrfAnyCycles 


Check graph for cycles 


Grf. 


2 


Public 


Y 


GrfAsEdgDB 


Return List of edges 


Grf. 


4 


Friend 


N 


GrfAsObj 


Return graph as object 


Grf. 


5 


Private 


N 


GflAsVtxDII 


Return Ust of vertices 


Grf- 


6 


Friend 


N 


GrfBasicTopologicalSort 


Do topological sort of graph 


N/A 




Undoc 


N 


GrfCIear 


Clear the graph 


Grf- 


7 


Public 


N 


GrfCountEdg 


Count edges of graph 


Grf. 


8 


Public 


Y 


VjM 1 wvUI II V LA 


Cnnnt vprtiff>3 of nranh 


Grf- 


10 


Public 


Y 


GrfDelnit 


Oeinitialize Graph object 


Grf- 


12 


Public 


N 


GrfDestroy 


Deinitialize Graph object and free space 


Grf- 


13 


Public 


N 


GrfDoTopologicalSort 


Do topological sort of graph 


Grf- 


14 


Public 


Y 


GrfFindEdgClient 


Visit search function: edges 


Grf- 


16 


Public 


N 


GrfRndVtxClient 


Visit search function: vertices 


Grf- 


18 


Public 


N 


GrfGetClient 


Return client of graph 


Grf- 


20 


Public 


N 


Grflnit 


Initialize Graph object 


Grf- 


21 


Pubfic 


N 


GrfSendDestroy 


Send message for graph destruction 


Grf- 


22 


Public 


N 


GrfVisitEdgClient 


Visit function: edges 


Grf- 


23 


Public 


N 


GrfVisitVtxClient 


Visit function: vertices 


Grf- 


25 


Public 


N 


GrfVisitVtxClientlnTopOrderBwd 


Visit function: backward topological order 


Grf- 


27 


Public 


N 


GrfVlsitVtxClientlnTopOrderFvyd 


Visit function: forward topological order 


Grf- 


29 


Public 


N 



Function Listing By Scope 

Public Functions 

Function Name Description Page Macro 



GrfAnyCycles 


Check graph for cycles 


Grf- 


2 


N 


GrfCIear 


Clear the graph 


Grf- 


•7 


N 


GrfCountEdg 


Count edges of graph 


Grf- 


8 


N 


GrfCountVtx 


Count vertices of graph 


Grf- 


•10 


N 


GrfDelnit 


Deinitialize Graph object 


Grf 


■12 


N 


GrfDestroy 


Deinitialize Graph object and free space 


Grf 


•13 


N 


GrfDoTopologicalSort 


Do topological sort of graph 


Grf 


•14 


N 


GrfFindEdgClient 


Visit search function: edges 


Grf 


•16 


N 


GrfRndVtxClient 


Visit search function: vertices 


Grf- 


18 


N 


GrfGetQient 


Return client of graph 


Grf- 


•20 


N 


Grflnit 


Initialize Graph object 


Grf- 


•21 


N 
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Public Functi ns(cont) 



Function Name 


Description 


Page 


Macro 


GrfSendDestroy 


Send message for graph destruction 


Grf 


•22 


N 


GrfVisitEdgClient 


Visit function: edges 


Grf 


•23 


N 


GrfVisitVtxClient 


Visit function: vertices 


Grf- 


•25 


N 


GrfVisitVtxClientlnTopOrderBwd 


Visit function: backward topological order 


Grf- 


•27 


N 


GrfVisilVtxClientlnTopOrderFwd 


Visit function: forward topological order 


Grf 


■29 


N 





Private Functions 






Function Name 


Description 


Page 


Macro 


GrfAsObj 


Return graph as object 


Grf-5 


N 



Undocumented Functions 



Function Name 


Description 


Page 


Macro 


GrfBasicTopologicaiSort 


Do topological sort of graph 


N/A 


N 



Friend Functions 



Function Name 


Description 


Page 


Macro 


GrfAsEdgDII 


Return List of edges 


Grf-4 


N 


GrfAsVtxDII 


Return List of vertices 


Grf-6 


N 



Listing Of Functions by Category 

Query Functions 



Function Name Description Page Scope Macro 



GrfAnyCycles 


Check graph for cycles 


Grf-2 


Public 




Y 


GrfCountEdg 


Count edges of graph 


Grf-8 


Public 




Y 


GrfCountVtx 


Count vertices of graph 


Grf -10 


Public 




Y 


GrfFindEdgClient 


Visit search function: edges 


Grf -16 


Public 




N 


GrfFmdVtxClient 


Visit search function: vertices 


Grf -18 


Public 




N 


GrfGetClient 


Return client of graph 


Grf -20 


Public 




N 
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Superclass Functions 



Function Name 


Descrinttan 


Pan a 




Macro 


GrfAsEdgDII 


Return List of edges 


Grf-4 


Friend 




N 


GrfAsObj 


Return graph as object 


Grf-5 


Private 




N 


GrfAsVtxDil 


Return List of vertices 


Grf-6 


Friend 




N 




Process Functions 










Function Name 


Description 


Page 


Scope 


Macro 


GrfBasicTopologicalSort 


Do topological sort of graph 


N/A 


Undoc 




N 


GrfDoTopologicalSort 


Oo topological sort of graph 


Grf-14 


Public 




Y 




Edit Functions 










Function Name 


Description 


Page 


Scope 


Macro 


GrtClear 


Clear the graph 


Grf-7 


Public 


N 



Initialization Functions 



Function Name 


Description 


Page 


Scope Macro 


GrfDelnit 


Deinitiafize Graph object 


Grf-12 


Public 


N 


GrfDestroy 


Deinitialize Graph object and free space 


Grf-13 


Public 


N 


Grflnit 


Initialize Graph object 


Grf-21 


Public 


N 


Intialization Functions 








Function Name 


Description 


Page 


Scope Macro 


GrfSendDestroy 


Send message for graph destruction 


Grf-22 


Public 


N 
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Visit Functions 



Function Name 


Description 


Page 


Scope Macro 


GrfVlsitEdgaient 


Visit function: edges 


Gil -23 


Public 


N 


GrfVisitVtxClient 


Visit function: vertices 


Grf-25 


Public 


N 


GrtVisitVtxClientinTopOrderBwd 


Visit function: backward topological order 


Grf-27 


n. .tm.lt 

Public 


N 


GrfVisitVtxClientlnTopOrderFwd 


Visit function: forward topological order 


Grf-29 


Public 


N 


Listing Of Functions With Macros Available 








Function Name 


Description 


Page 


Scope 




GrfAnyCycles 


Check graph for cycles 


Grf-2 


Public 




GrfCountEdg 


Count edges of graph 


Grf-8 


Public 




GrfCountVtx 


Count vertices of graph 


Grf-10 


Public 




GrfDoTopologicalSort 


Do topological sort of graph 


Grf-14 


Public 
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Class Description for JulianTime 



Structure Name: 



JulianTime 



Abbreviation: 



Jul 



Class Type: 



Primitive 



Introduction 

The JulianTime class is used for modeling and manipulating calendar dates. It 
is best suited for applications where the calculations involving the arithmetical 
calculation of dates are more frequent than the formatting of dates for display. 

The formatting functions provided by JulianTime are somewhat on the weak 
side. This class is really designed for date calculations. Future releases of this 
class will improve on its formatting capabilities. 

Description 

The JulianTime class provides functions for representing a specific day of a 
year as a Julian date. A Julian date is the number of days that have elapsed 
since noon GMT on January 1, 4713 BC. This is the Julian day number. The 
consecutive numbering of days makes the system independent of the length of 
a month or year and is optimal for doing many date calculations. 
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Glossary and Special Terms 

Julian Day Number: 

The number of days that have elapsed since noon GMT on January 1, 4713 
BC. 

Example - Julian day on March 1st. 

1940 = 2429690 

1980 = 2444300 

1990 = 2447952 



Date Format: 

JidionTime functions with formating arguments use an enum DateFormat as 
the argument. These format identifiers are as follows: 

United States format MM-DD-YYYY has the enum DFJJS. 

European format DD-MM-YYYY has the enum DF_EUROPE. 

Military format YYYY-MM-DD has the enum DF_MILITARY. 



The algorithm implemented for the Julian day conversion is valid for the 
Gregorian calendar. Valid years are therefore 1583 AD to 4713 AD. 

Class Implementation JulianTime 

Instance Variables 

The structure definition for JulianTime is as follows: 
struct JulianTime { ULargelnt time; } 

time Julian day number. 
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Class Variables 

The following class variables are used by the JulianTime class: 

The class variable monthSize contains the size of each month of the year. The 
size of the second month (February) is preset to be a non leap year. 

Mediumlnt monthSize[1 2] = {31 ,28,31 ,30,31 ,30,31 ,31 ,30,31 ,30,31 }; 

The class variable quarterSize contains the size of each quarter of the year. 

Mediumlnt quarterSize[4] = {90,91,92,92}; 

The class variable weekMonthName contains the strings to be used to create 
the date string in the JulWeekString function. 

Char weekMonthName[12][4] = { "Jan", "Feb", "Mar, "Apr, "May", "Jun", "Jul", "Aug", 
"Sep", "O 60"Nov", "Dec" }; 

The class variable MonthName contains the strings to be used to create the 
date string in the JulMonthString function. 

Char MonthName[12][4] = { "Jan", "Feb", "Mar, "Apr, "May", "Jun", "Jul", "Aug", "Sep", 
"Oct", 60"Dec" }; 

The class variable QuarterName contains the strings to be used to create the 
date string in the JulQuarterString function. 

Char QuarterName[4][8] = { "1st Qtr, "2nd Qtr, "3rd Qtr, "4th Qtr }; 
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Function Listing In Alphabetic Order 



Function Name Description Page Scope Macro 
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-34 
v*t 


Puhlir 

r u viiv 


Y 


JulIsLeapYear 


Is date in leap year 


Jul 


•36 


Public 


N 


JuIIsMaxValue 


Is date maximum juiian value 


Jul 


■38 


Public 


Y 


JulMax 


The maximum of two juiian dates 


Jul 


•40 


Public 


Y 


JulMin 


The minimum of two juiian dates 


Jul 


•42 


Public 


Y 


JulMonthDayDiff 


Days between date and a day/month 


Jul 


•44 


Public 


N 


JulMonthString 


Fill string with month and year 


Jul 


•46 


Public 


N 


JulQuarterString 


Fill string with quarter and year 


Jul 


•48 


Public 


N 


JulSameDayMonth 


Two dates same day and month 


Jul 


•50 


Public 


N 


JutSetMaxDate 


Set date to maximum value 


Jul 


•52 


Public 


N 


JulToCalendar 


Julian day to day, month, year 


Jul 


•54 


Public 


N 


JulToDateStr 


Fill date string of specified format 


Jul 


•56 


Public 


N 


JulValidateDate 


Validate date passed as string 


Jul 


■58 


Public 


N 


JulWeekString 


Fill string with day and month 


Jul 


•60 


Public 


N 


JulYearString 


Fill string with year 


Jul 


■62 


Public 


N 
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Function Listing By Scope 

Public Functions 
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JullsLeapYear 


Is date in leap year 


Jui -36 


N 


JullsMaxValue 


Is date maximum juiian value 


Jul -38 


N 


JulMax 


The maximum of two juiian dates 


Jul -40 


N 


JulMin 


The minimum of two juiian dates 


Jul -42 


N 


JulMonthDayOiff 


Days between date and a day/month 


Jul -44 


N 


JulMonthString 


Fill string with month and year 


Jul -46 


N 


JulQuarterString 


Rll string with quarter and year 


Jul -48 


N 


JulSameDayMonth 


Two dates same day and month 


Jul -50 


N 


JulSetWaxDate 


Set date to maximum value 


Jul -52 


N 


JulToCalendar 


Julian day to day, month, year 


Jul -54 


N 


JulToDateStr 


Rll date string of specified format 


Jul -56 


N 


JulValidateDate 


Validate date passed as string 


Jul -58 


N 


JulWeekString 


Fill string with day and month 


Jul -60 


N 


JulYearSlring 


Rll string with year 


Jul -62 


N 



Private Functions 



None 
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Undocumented Functions 



None 








Friend Functions 


None 









Listing Of Functions by Category 

Arithmetical Functions 



Function Name 


Description 


Page 


Scope Macro 


JulAddDays 


Add/subtract days to date 


Jul -2 


Public 


Y 


JulAddDaysL 


Add/subtract days to date (long) 


Jul -4 


Public 


Y 


JulAddMonths 


Add/subtract months to date 


Jul -6 


Public 


N 


JulAddQuarters 


Add/subtract quarters to date 


Jul -8 


Public 


N 


JulAddYears 


Add/subtract years to date 


Jul -10 


Public 


N 


JulDiff 


Days between two dates 


Jul -28 


Public 


Y 


JulOiffL 


Days between two dates (long) 


Jul -30 


Public 


Y 


Jullnit 


Set to beginning of calendar January 1 , 1583 


Jul -34 


Public 


Y 


JuIMax 


The maximum of two Julian dates 


Jul -40 


Public 


Y 


JulMin 


The minimum of two Julian dates 


Jul -42 


Public 


Y 


JulMonthDayDiff 


Days between date and a day/month 


Jul -44 


Public 


N 



Conversion Functions 
Function Name Description Page Scope Macro 



JulCalendarToJulian 


Day, month, year to julian day 


Jul 


-12 


Public 


N 


JulDateStrToJulian 


Date string to julian day 


Jul 


-16 


Public 


N 


JulGetSystemJuBanDay 


System date as julian day 


Jul 


-32 


Public 


N 


JulToCalendar 


Julian day to day, month, year 


Jul 


-54 


Public 


N 


JulValidateDate 


Validate date passed as string 


Jul 


-58 


Public 


N 
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Miscellaneous Functions 



Function Name Description Page Scope Macro 



JutCopy 


Copyjulian day 


Jul -14 


Public 




Y 


JulSetMaxDate 


Set date to maximum value 


Jul -52 


Public 




N 



Query Functions 



Function Name 


Description 


Page 


Scope Macro 


JulDayOfWeek 


Day number in week 


Jul -18 


Public 


Y 


JulDayOfYear 


Day number in year 


Jul -20 


Public 


N 


JulDayslnMonth 


Days in month 


Jul -22 


Public 


N 


JulDayslnQuarter 


Days in quarter 


Jul -24 


Public 


N 


JulDayslnYear 


Days in year 


Jul -26 


Public 


N 


JullsLeapYear 


Is date in leap year 


Jul -36 


Public 


N 


JullsMaxValue 


Is date maximum julian value 


Jul -38 


Public 


Y 


JuISameDayMonth 


Two dates same day and month 


Jul -50 


Public 


N 



Formatting Functions 



Function Name 


Description 


Page 


Scope Macro 


JulMonthString 


nil string with month and year 


Jul -46 


Public 


N 


JulQuarterString 


Rll string with quarter and year 


Jul -48 


Public 


N 


JulToDateStr 


Fill date string of specified format 


Jul -56 


Public 


N 


JulWeekString 


Fill string with day and month 


Jul -60 


Public 


N 


JulYearString 


Fill string with year 


Jul -62 


Public 


N 


Listing Of Functions With Macros Available 








Function Name 


Description 


Page 


Scope 




JulAddDays 


Add/subtract days to date 


Jul -2 


Public 




JulAddDaysL 


Add/subtract days to date (long) 


Jul -4 


Public 




JulCopy 


Copy julian day 


Jul -14 


Public 




JulDayOfWeek 


Day number in week 


Jul -18 


Public 




JulDiff 


Days between two dates 


Jul -28 


Public 




JulDiffL 


Days between two dates (long) 


Jul -30 


Public 




Jullnit 


Set to beginning of calendar January 1, 1583 


Jul -34 


Public 




JullsMaxValue 


Is date maximum julian value 


Jul -38 


Public 




JulMax 


The maximum of two julian dates 


Jul -40 


Public 




JulMin 


The minimum of two julian dates 


Jul -42 


Public 
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Class Description for ListElement 



Structure Name: ListElement 

Abbreviation: Lei 

Class Type: Inheritable class 



Introduction 

The ListElement class has a friend class List The documentation for the 
ListElement class should therefore be read in conjunction with the List class. 

When sequential mapping is used for ordered lists, achieved using an array 
data structure, operations such as insertion and deletion of arbitrary elements 
become expensive because of the amount of data movement. Linked 
representations of ordered lists are an alternative to sequential 
representations. 

Description 

Unlike a sequential representation where successive items of a list are located 
a fixed distance apart, in a linked representation these items may be placed 
anywhere in memory. Each element points to the next element in the list and 
the previous element in that list. These elements are stored as part of the class 
ListElement. 

Besides the linked items a special node exists called the head node. The head 
node stores the first and last elements in the list. C+O stores the head node as 
part of the class List ListElements also store a pointer to the List they belong to 
(if any). 

It is customary to draw linked lists as an ordered sequence of nodes with links 
being represented by arrows. Figure 1 shows a sample doubly linked list with 4 
nodes {ListElements] A, B, C and D. The head node {List) points to nodes A and 
D. 

Head node 



Figure 1 
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The List class is the data structure representation of the head node. The 
ListElement class is the data structure representation of a single element in a 
doubly linked list. 



Glossary and Special Terms 

Figure 2 shows the first and last element in a doubly linked list. Because each 
list element stores a pointer to the List class ( head node ) the first and last 
elements are also accessible from each element. 

To get from the first element to the last element you would access successor, 
or next elements. To get from the last element to the first element you would 
access predecessor or previous elements. 

The predecessor of the first element is NULL. The successor to the last element 
is NULL. All other elements will have non-NULL predecessors and successors. 
There exists only zero or one predecessor for a given element. 




Figure 2 



A range of list elements is defined as a beginning list element and an ending 
list element. Figure 3 shows a doubly linked list with size 8. 

Examples of a valid range of list elements: 

1) A through H, here the range is from first to last. 2) C through E, here the 
range spans elements C, D and E. 3) F through F, here the range spans one 
element, F. 
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Examples of an invalid range of list elements: 

1) E through A, here the range is backwards. 2) A through I, here the range 
spans outside the list. 




Figure 3 



Class Implementation ListElement 



Instance Variables 

The following is the data structure definition for a list element. 

struct ListElement { Obj obj; 

Mediumlnt lelCheck; 

PDLL pDII; 

PLEL prev; 

PLEL next; } 

obj Gives ListElement class properties of inheritance and 

dynamic binding. 
lelCheck Uniquely identifies ListElement instances. 

pDll Pointer to List that the ListElement belongs to. 

prev Previous ListElement in the list, 

next Next ListElement in the list. 
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Messages and Responses 

The implementation of the destroy message is handled by LelDestroy but 

should be overridden by the subclass. The destroy message is not used by any 
Lei methods. 

Selector Method Description 

destroy LelDestroy Destroy the object 
Class Variables 

Typ e Name Description 

Mcl LeIMcl Metaclass description for ListElement. 
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Function Listing in Alphabetic Order 



runcuon Name 


Description 


Page 


Scope Macro 


LulnSUD) 


Return element as object 


Lei -2 


Private 
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LeiuiieniLrOUni 


Return count for client and successors 
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Public 
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1 otPJiantntl 


Heturn client of list 


Lei -5 


Public 


Y 


1 ©IfMianfPinHPanno 

Lciuiiciurinandiigc 


Visit search function: range 


Lei -6 


Public 
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1 olPliontMovt 
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Hetum client or next element 


Lei -8 


Pnhlir 


Y 


Leioiienirrev 


Return client of previous element 


Lei -9 


Public 


Y 


LeiuienivisJtbwa 


Visit function: client and predecessors 


Lei - 10 


Pnhlir 


IN 


Lei o i iero v isiirwu 


Visit function: client and successors 


Lei -12 


Puhlir 




LeICIientVisi [Predecessors 


Visit function: predecessors 


Lei -14 


Public 


N 


LeiviieniviSKnange 


Visit function: range 


Lei -16 


Public 


N 


Lciuienivisuouccessors 


Visit function: successors 


Lei - 18 


Public 


N 
ii 


LeivjountKange 


Count elements 


Lei -20 


Puhlir 


N 
ii 


LeiLrUl 


Cut element from list 


Lei - 22 


Public 


M 
ii 


LeiLrUtKange 


Cut element(s) from list 


Lei - 24 


Puhlir 


N 
ii 


Leiuuinangerromust 


Cut element(s) from list 


N/A 


Undor 


N 
ii 


Lei ue inn 


Deinitialize list element object 


Lei - 26 


Public 


N 


Leiuestroy 


Deinitialize list element object and free space 


Lei - 27 


Public 


N 


LeIGetCIient 


Return client 


Lei -28 


Public 


Y 


LeIGetDII 


Return list object 


Lei -29 


Friend ' 


Y 


LeIGetNext 


Return next element 


Lei -30 


Friend 


Y 


LeIGetNthSuccessor 


Return Nth element 


Lei -31 


Friend 


N 


LeIGetPrev 


Return previous element 


Lei -32 


Friend 


Y 


Lellnit 


Is element in list 


Lei -33 


Public 


N 


LeIPasteRangeAfter 


Append elements(s) to list 


Lei -34 


Public 


N 


LeIPasteRangeBefore 


Insert elements) to list 


Lei -36 


Public 


N 


LeIPasteRangeToList 


Insert elements) to list 


N/A 


Undoc 


N 


LeISendDestroy 


Send message for list element destruction 


Lei -38 


Public 


N 


LeITest 


Test for valid list element 


Lei -39 


Public 


N 


LeIVisitRange 


Visit function for range 


Lei -40 


Private 


N 
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Function Listing By Scope 

Public Functions 



Function Name 


Description 


Page 


Macro 


LeOentCount 


Return count for client and successors 


Lel-3 


N 


LeICIientDII 


Return client of list 


Lei -5 


N 


LelClientRndRange 


Visit search function: range 


Lel-6 


N 


LeICIientNext 


Return dient of next element 


Lei -8 


N 


LeICIientPrev 


Return dient of previous element 


Lel-9 


N 


LeICIientVtsitBwd 


Visit function: client and predecessors 


Lei -10 


N 


LelQientVisitFwd 


Visit function: client and successors 


Lei- 12 


N 


1 olf^liontV/icitPrwforpccnrc 

Ltil V/ilui U V lot lr 1 cucUC dOvl d 


Vteit function* nrpdscessors 


Lei - 14 


N 


LeICIientVisitRange 


Visit function: range 


Lei -16 


N 


LeICIientVisitSuccessors 


Visit function: successors 


Lei -18 


N 


Leiuountnange 


f*r\t mt alamonte 
UuUill clcil IclUo 


Lei -20 


N 


LeICut 


Cut element from list 


Lei -22 


N 




Cut plpmpnttel from list 


Lei - 24 


N 


LeIDelnit 


Deinitialize list element object 


Lei -26 


N 


LeIDestroy 


Deinitialize list element object and free space 


Lei -27 


N 


I olftotPJiont 
LBlUGll/tlGill 


Qptum dipnt 


Lei -28 


N 


Lellnit 


Is element in list 


Lei -33 


N 


LelPasteRange After 


Append elements(s) to list 


Lei -34 


N 


LeIPasteRangeBefore 


Insert elements) to list 


Lei • 36 


N 


LeISendDestroy 


Send message for list element destruction 


Lei -38 


N 


LeITest 


Test for valid list element 


Lei -39 


N 




Private Functions 






Function Name 


Description 


Page 


Macro 


LeIAsObj 


Return element as object 


Lei -2 


N 


LeIVisitRange 


Visit function for range 


Lei -40 


N 


Undocumented Functions 






Function Name 


Description 


Page 


Macro 


LeICutRangeFromList 


Cut element(s) from list 


N/A 


N 


LelPasteRangeTolist 


Insert elements) to list 


N/A 


N 
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ListElement 



Friend Functions 



Function Name 


Description 


Page 


Macro 


LelGetm 


Return list object 


Lei -29 


N 


LeIGetNext 


Return next element 


Lei -30 


N 


LeIGetNthSuccessor 


Return Nth element 


Lei -31 


N 


LeIGetPrev 


Return previous element 


Lei -32 


N 



Listing Of Functions by Category 

Superclass Functions 



Function Name 


Description 


Page 


Scope Macro 


LeIAsObj 


Return element as object 


Lei -2 


Private 


Y 




vjuery runciions 








Cim4*ttan Mom a 

runcuon name 


uescnpuon 


rage 


Scope Macro 


LeICIientCount 


Return count for client and successors 


Lei -3 


Public 


N 


LeICIientDII 


Return client of list 


Lei -5 


Public 


Y 


LeICIientFtndRange 


Visit search function: range 


Lei -6 


Public 


N 


LeIClientNext 


Return client of next element 


Lei -8 


Public 


Y 


LelClientPrev 


Return client of previous element 


Lei -9 


Public 


Y 


LeICountRange 


Count elements 


Lei -20 


Public 


N 


LeIGetClient 


Return client 


Lei -28 


Public 


Y 


LeIGetDII 


Return list object 


Lei -29 


Friend 


Y 


LeIGetNext 


Return next element 


Lei -30 


Friend 


Y 


LeIGetNthSuccessor 


Return Nth element 


Lei -31 


Friend 


N 


LeIGetPrev 


Return previous element 


Lei -32 


Friend 


Y 


Lellnit 


Is element in list 


Lei -33 


Public 


N 




Visit Functions 








Function Name 


Description 


Page 


Scope Macro 


LeICIientVisitBwd 


Visit function: client and predecessors 


Lei - 10 


Public 


N 


LeICIientVisitFwd 


Visit function: client and successors 


Lei - 12 


Public 


N 


LeICIientVisitPredecessors 


Visit function: predecessors 


Lei - 14 


Public 


N 


LeICIientVisitRange 


Visit function: range 


Lei - 16 


Public 


N 


LeICIientVisitSuccessors 


Visit function: successors 


Lei - 18 


Public 


N 


LelVisitRange 


Visit function for range 


Lei -40 


Private 


N 
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Edit Functions 



Function Name 


Description 


Page 


Scope Macro 


LelCut 


Cut element from list 


Lei -22 


Public 


N 


LelCutRange 


Cutelement(s) from list 


Lei -24 


Public 


N 


LelCutRangeFromList 


Cut element(s) from list 


N/A 


Undoc 


N 


LeIPasteRangeAfter 


Append elements(s) to list 


Lei -34 


Public 


N 


LeIPasteRangeBefore 


Insert elements) to list 


Lei -36 


Public 


N 


LelPasteRangeToList 


Insert elements) to list 


N/A 


Undoc 


N 



Initialization Functions 
Function Name Description Page Scope Macro 



LeIDelnit 


Deinitialize list element object 


Lei -26 


Public 


N 


LeIDestroy 


Deinitialize list element object and free space 


Lei -27 


Public 


N 


LeISendDestroy 


Send message for list element destruction 


Lei -38 


Public 


N 




Debug Functions 








Function Name 


Description 


Page 


Scope Macro 


LeITest 


Test for valid list element 


Lei -39 


Public 


N 


Listing Of Functions With Macros Available 








Function Name 


Description 


Page 


Scope 




LeIAsObj 


Return element as object 


Lei -2 


Private 




LeICIientDil 


Return client of list 


Lei -5 


Public 




LelClientNext 


Return client of next element 


Lei -8 


Public 




LeICIientPrev 


Return client of previous element 


Lei -9 


Public 




LeIGetClient 


Return client 


Lei -28 


Public 




LeIGetDII 


Return list object 


Lei -29 


Friend 




LeIGetNext 


Return next element 


Lei -30 


Friend 




LeIGetPrev 


Return previous element 


Lei -32 


Friend 
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Class Description for MetaClass 



Structure Name: 



MetaClass 



Abbreviation: 



Mcl 



Class Type: 



Primitive Class 



Introduction 

MetaClasses are used to create objects of type Class. By analogy, a MetaClass 
is to a Class, what a Class is to an Object. While ultimately it is Objects 
(instantiations of some structure or type) which we are interested in, we start 
by defining an instance of MetaClass. 

Whenever you define a structure (class) which you want to have the object- 
oriented properties of inheritance or dynamic binding, you must do three 
things and in the following order. 

First, the structure must contain, as the first structure member, a structure of 
type Object. Objects allow you to send messages (dynamic binding) and access 
subclasses (a class which inherits from your structure). 

Second, you must define and initialize an instance of the structure MetaClass 
which describes the Class, its messages, and its superclass (classes which 
your class inherits from). Normally you will initialize the MetaClass instance at 
compile time. 

Third, your program must call MclSendCreateClass, passing the MetaClass 
instance you defined in Step 2. The return value is (a pointer to) an instance of 
Class. 

Now your program can create objects (memory allocated for the structure) of 
the Class you defined by calling ClsCreateObject and passing the pointer 
returned by MclSendCreateClass. When an object is no longer needed, you call 
ObjDestroy which deallocates the memory for that object. 
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MetaClass 



MetaClass, along with Class, Object, Message, MetaSuperClass, MetaMessage, 
and Block collectively define and implement the object-oriented properties of 
inheritance and dynamic binding (messaging) in C+O class libraries. 
Encapsulation, while supported by the above code, can be implemented by the 
programmer simply writing enough functions for a structure to obviate the 
need to access the structure members directly. These classes should be studied 
as a group to understand how C+O implements object-oriented C programs. 

For further information, read the tutorial section and also study the class 
header files dllcls.h, lelcls.h, and trecls.h. These headers define instances of 
MetaClass, MetaSuperClass and MetaMessage. 



Description 

An instance of MetaClass references an array of MetaSuperClasses and an 
array of MetaMessages. In its simplest form, an instance of MetaClass need 
only describe the name of the Class and the size of an object of that Class. 
Please refer to the sections on MetaMessage and MetaSuperClass for more 
information on defining instances of those classes. 

A MetaClass is used to define all the constant information about a structure; it 
defines its size, the messages it responds to, and its superclasses. 

The reader should famiali arize himself with the structure definition of 
MetaClass since you will be initializing instances of MetaMessage statically. 



Glossary and Special Terms 

There is no special glossary for MetaClass. Instead, refer to the tutorial section 
on object-oriented techniques in C+O. 
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MetaClass 



Class Implementation MetaClass 



Instance Variables 

The following is the data structure definition for a directed graph. 



struct MetaClass { 



mclCheck 

name 

clsSize 

objSize 

mmsArray 

mmsSize 

mscArray 

mscSize 

createFunc 

destroyFunc 

Superclasses 



Mediumlnt mclCheck; 

PSTR name; 

Mediumlnt clsSize; 

Mediumlnt objSize; 

PMMS mmsArray; 

Mediumlnt mmsSize; 

PMSC mscArray; 

Mediumlnt mscSize; 

PCLS (*createFunc)(PMCL); 

Void (*destroyFunc)(PCLS); } 

Uniquely identifies MetaClass instances. 

Name of the structure being modeled. 

Size of the Class structure or extended Class structure 

Size of the structure being modeled. 

An array of MetaMessages. 

Number of MetaMessages in mmsArray. 

An array of MetaSuperClasses. 

Number of MetaSuperClasses. 

A function which will create a Class instance. 

A function which will destroy a Class instance. 



MetaClass has no superclasses. 

Messages and Responses 

MetaClass does not have any messages since it is a primitive class. 
Class Variables 



MetaClass has no class variables. 
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Function Listing In Alphabetic Order 



Function Name 


Description 


Page 


Scope Macro 


MclCreateClass 


Create a class instance 


Mcl-2 


Private 




MclDestroyClass 


Destroy a class instance 


Mcl-3 


Friend 


M 
IN 


McIRndSelector 


Find a selector index given its name 


Mcl-5 


Pnhlir 




MciRndSuperClass 


Find the superclass index given its name 


Mcl-6 


Public 


N 


MclGetClassName 


Get the class name 


Mcl-7 


Public 


N 


MclGetClassSize 


Return the size of a class instance 


Mcl-8 


Public 


N 


MciGetMessageCount 


Return the number of messages 


Md-9 


Public 


N 


MclGetNthMms 


Return the Nth MetaMessage. 


Mcl-10 


Public 


N 


MclGetNthOffset 


Return the Nth Superclass offset 


Mcl-11 


Public 


N 


MclGetNthSuper 


Return the MetaClass 


Md-12 


Public 


N 


MclGetSuperClassCount 


Return the number of superclasses 


Mcl-13 


Public 


N 


MclPrint 


Print the MetaClass instance 


Md-14 


Public 


N 


MclSendCreateClass 


Return a new instance of the MetaClass 


Md-15 


Public 


N 


MclSendDestroyClass 


Deallocate an instance of a Class 


Md-16 


Public 


N 


MclValidate 


Validate that the instance is valid 


Mcl-17 


Public 


N 


MclValidateMessages 


Validate the MetaMessages 


N/A 


Undoc 


N 


MclValidateSuperClasses 


Validate the MetaSuperClasses 


N/A 


Undoc 


N 



Function Listing By Scope 

Public Functions 



Function Name 


Description 


Page 


Macro 


McIRndSelector 


Find a selector index given its name 


Mcl-5 


N 


MclFindSuperClass 


Find the superclass index given its name 


Mcl-6 


N 


MclGetClassName 


Get the class name 


Mcl-7 


N 


MclGetClassSize 


Return the size of a class instance 


Mcl-8 


N 


MciGetMessageCount 


Return the number of messages 


Mcl-9 


N 


MclGetNthMms 


Return the Nth MetaMessage 


Mcl-10 


N 


MclGetNthOffset 


Return the Nth Superclass offset 


Mcl-11 


N 


MclGetNthSuper 


Return the MetaClass 


Mcl-12 


N 


MclGetSuperClassCount 


Return the number of superclasses 


Mcl-13 


N 


MclPrint 


Print the MetaClass instance 


Md-14 


N 


MclSendCreateClass 


Return a new instance of the MetaClass 


Mcl-15 


N 


MclSendDestroyOass 


Deallocate an instance of a Class 


Mcl-16 


N 


MclValidate 


Validate that the instance is valid 


Mcl-17 


N 
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MetaClass 



Private Functions 



Function Name 


Description 


Page 


Macro 


MclCreateClass 


Create a dass instance 


Md-2 


N 


Undocumented Functions 






Function Name 


Description 


Page 


Macro 


MclValidateMessages 


Validate the MetaMessages 


N/A 


N 


MclValidateSuperClasses 


Validate the MetaSuperClasses 


N/A 


N 




Friend Functions 






Function Name 


Description 


Page 


Macro 


MclDestroyClass 


Destroy a class instance 


Mcl-3 


N 



Listing Of Functions by Category 

Class Functions 



Function Name 


Description 


Page 


Scope Macro 


MclCreateClass 


Create a class instance 


Md-2 


Private 


N 


MclDestroyClass 


Destroy a class instance 


Mcl-3 


Friend 


N 


MclSendCreateClass 


Return a new instance of the MetaClass 


Mcl -15 


Public 


N 


MclSendDestroyClass 


Deallocate an instance of a Class 


Mcl- 16 


Public 


N 



Query Functions 



Function Name 


Description 


Page 


Scope Macro 


MclFindSelector 


Find a selector index given its name 


Mcl-5 


Public 


N 


MclFindSuperClass 


Find the superclass index given its name 


Mcl -6 


Public 


N 


MclGetClassName 


Get the class name 


Mcl -7 


Public 


N 


MclGetClassSize 


Return the size of a class instance 


Mcl-8 


Public 


N 


MclGetMessageCount 


Return the number of messages 


Md-9 


Public 


N 


MclGetNthMms 


Return the Nth MetaMessage 


Mcl - 10 


Public 


N 


MclGetNthOffset 


Return the Nth Superclass offset 


Mcl -11 


Public 


N 


MclGetNthSuper 


Return the MetaClass 


Mcl -12 


Public 


N 


MclGetSuperClassCount 


Return the number of superclasses 


Mcl -13 


Public 


N 
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Debug Functions 



Function Name Description Page Scope Macro 



MdPrint 


Print the MetaClass instance 


Mcl-14 


Public 


N 


MclVafidate 


Validate that the instance is valid 


Mcl-17 


Public 


N 


MclValidateMessages 


Validate the MetaMessages 


N/A 


Undoc 


N 


MclValidateSuperClasses 


Validate the MetaSuperClasses 


N/A 


Undoc 


N 



Listing Of Functions With Macros Available 



None 
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Description for Memory 



Structure Name: 



Memory 
Mem 



Abbreviation: 



Class Type: 



Primitive Class 



Introduction 

The Memory class is used to manipulate arrays of bytes. Each element can be 
an arbitrary number of bytes wide. It is used by the DynamicArray class to 
implement many low level functions. 

Description 

The Memory class is an abstract representation of raw, unstructured 
sequential bytes of memory. It is the most primitive class in C+O. Many other 
classes use Mem for allocation and deallocation of memory. 

Glossary and Special Terms 

There is no special glossary for this class. 



Class Implementation Memory 



Instance Variables 



Memory is implemented as a typedef Char Memory. 
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Memory 



Superclasses 

The Memory class is primitive and has no superclasses. 

Messages and Responses 

The Memory class is primitive and has no messages. 

Class Variables 

The Memory class has no class variables. 



Function Listing In Alphabetic Order 



Function Name Description Page Scope Macro 



MemClear 


Clears array elements 


Mem -2 


Public 




N 


MemCopy 


Copy array elements within the array 


Mem -3 


Public 




N 


MemCutNSet 


Delete elements, shift remaining 


Mem -5 


Public 




N 


MemDestroy 


Deallocate memory 


Mem -6 


Public 




N 


MemDuplicate 


Copy array into another 


Mem -7 


Public 




N 


MemNew 


Allocate memory 


Mem -8 


Public 




N 


MemPasteNSet 


Expand array, shift remaining 


Mem -9 


Public 




N 


MemSetChr 


Set elements to character 


Mem - 10 


Public 




N 



Function Listing By Scope 

Public Functions 

Function Name Description Page Macro 



MemClear 


Clears array elements 


Mem 


•2 


N 


MemCopy 


Copy array elements within the array 


Mem 


-3 


N 


MemCutNSet 


Delete elements, shift remaining 


Mem 


-5 


N 


MemDestroy 


Deallocate memory 


Mem 


-6 


N 


MemDuplicate 


Copy array into another 


Mem 


•7 


N 


MemNew 


Allocate memory 


Mem 


•8 


N 


MemPasteNSet 


Expand array, shift remaining 


Mem 


•9 


N 


MemSetChr 


Set elements to character 


Mem 


•10 


N 
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Privat Functi ns 


None 









Undocumented Functions 



None 









Friend Functions 



None 



Listing Of Functions by Category 

Array Functions 



Function Name 


Description 


Page 


Scope Macro 


MemClear 


Clears array elements 


Mem -2 


Public 


N 


MemCopy 


Copy array elements within the array 


Mem -3 


Public 


N 


MemCutNSet 


Delete elements, shift remaining 


Mem -5 


Public 


N 


MemDupGcate 


Copy array into another 


Mem -7 


Public 


N 


MemPasteNSet 


Expand array, shift remaining 


Mem -9 


Public 


N 


MemSetChr 


Set elements to character 


Mem - 10 


Public 


N 


Initialization Functions 








Function Name 


Description 


Page 


Scope Macro 


Mem Destroy 


Deallocate memory 


Mem -6 


Public 


N 


MemNew 


Allocate memory 


Mem -8 


Public 


N 


Listing Of Functions With Macros Available 


J None 
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Class Description for Meta Message 



Structure Name: 



MetaMessage 
Mms 



Abbreviation: 



Class Type: 



Primitive Class 



Introduction 

A MetaMessage is a definition of a message. MetaMessages allow a MetaClass 
to create an instance of Message which describes the final mapping of a 
message to a function. 

Instances of MetaMessage are always declared and initialized as part of an 
array. The array is associated with an instance of MetaClass. 

MetaClass, along with Class, Object, Message, MetaSuperClass, MetaMessage, 
and Block collectively define and implement the object-oriented properties of 
inheritance and dynamic binding (messaging) in C+0 class libraries. 
Encapsulation, while supported by the above code, can be implemented by the 
programmer simply writing enough functions for a structure to obviate the 
need to access the structure members directly. These classes should be studied 
as a group to understand how C+O implements object-oriented C programs. 

For further information, read the tutorial section and also study the class 
header files dllcls.h, lelcls.h, and trecls.h. These headers define instances of 
MetaClass, MetaSuperClass and MetaMessage. 
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MetaMessage 



Description 

An instance of MetaMessage describes the selector (name) for the message, the 
method to execute for this message, and the superclass (if any) this message 
was defined by. 

The reader should famialiarize himself with the structure definition of 
MetaMessage since you will be initializing instances of MetaMessage statically. 

The following rules apply when defining instances of MetaMessage: 

1) If the method structure member is initialized to NULL and the superclass 
member is NULL, it means a subclass must implement the message. 

2) If the method structure member is initialized to NULL and the superclass 
member is not NULL, then the method is inherited from the superclass named. 
In this case, the MetaMessage serves the purpose of propagating the message 
to a subclass which can override it if it so chooses. 

3) If the method structure member is non-NULL and the superclass member is 
NULL it means the message originates from the class which owns this message. 
A subclass can override this message. 

4) If the method structure member is non-NULL and the superclass member is 
non-NULL it means the superclass method is being overridden, not only for 
this class, but the superclass being overriden. This occurs for each level of 
superclass where the message was being overridden. A subclass can override 
this message. 

5) If the method structure member is equal to the constant -1, it means we do 
not want to allow a subclass to override this message. Following this 
MetaMessage should be one which actually defines the message. 

8) If the same message selector is defined by two or more superclasses, you 
should define a MetaMessage for each one. In effect, both are handled 
independently. This points out the advantage of an explicit inheritance 
mechanism where you must explicitly inherit messages from a superclass 
rather than have them "appear" automatically. 

9) If a subclass overrides a message, any following messages with the same 
selector are also overriden IF they have the same implementation, i.e., if the 
method structure member is identical. 

10) If there is more than one occurrence of a selector in the list of messages 
(because of identical selectors from different superclasses), the one nearest the 
top of the array will have priority over the others. This comes into play when 
looking up a message based on its selector string. 
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MetaMessage 



Glossary and Special Terms 

No special glossary exists for MetaMessage. Instead, refer to the tutorial 
section on object-oriented techniques. 

Class Implementation MetaMessage 

Instance Variables 

The following is the data structure definition for MetaMessage. 
struct MetaMessage { Mediumlnt mmsCheck; 



superClsName Name of the superclass which also has this message 
selector Name of the message. 

method The function which (optionally) overrides the supercl 

method. 

Superclasses 

MetaMessage is a primitive class and has no superclasses. 

Messages and Responses 

MetaMessage is a primitive class and therefore has no messages. 

Class Variables 

MetaMessage has no class variables. 



PSTR 
PSTR 
PMTH 



superClsName; 
selector; 
method; } 



mmsCheck 
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Function Listing In Alphabetic Order 



Function Name Description Page Scope Macro 



MmsGetMethod 


Get the method 


Mms -2 


Public 




N 


MmsGetSelector 


Get the name of selector 


Mms -6 


Public 




N 


MmsGetSuper 


Get name of superclass 


Mms -4 


Public 




N 


MmsPrint 


Display the instance 


Mms-7 


Public 




N 


MmsValidate 


Validate the instance 


Mms-8 


Public 




N 



Function Listing By Scope 

Public Functions 

Function Name Description Page Macro 



MmsGetMethod 


Get the method 


Mms 


•2 


N 


MmsGetSelector 


Get the name of selector 


Mms 


•6 


N 


MmsGetSuper 


Get name of superclass 


Mms- 


•4 


N 


MmsPrint 


Display the instance 


Mms 


•7 


N 


MmsValidate 


Validate the instance 


Mms 


•8 


N 



Private Functions 



None 









Undocumented Functions 



None 



Friend Functions 



None 
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Listing Of Functions by Category 

Query Functions 



Function Name 


Description 


Page 


Scope Macro 


MmsGetMethod 

MmsGetSelector 

MmsGetSuper 


Get the method 

Get the name of selector 

Get name of superclass 


Mms-2 
Mms-6 
Mms-4 


Public 
Public 
Public 


N 
N 
N 




Debug Functions 








Function Name 


Description 


Page 


Scope Macro 


MmsPrint 
MmsValidate 


Display the instance 
Validate the instance 


Mms-7 
Mms-8 


Public 
Public 


N 
N 


Listing Of Functions With Macros Available 


None 
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Class Description for MetaSuperClass 



Structure Name: 



MetaSuperClass 
Msc 



Abbreviation: 



Class Type: 



Primitive Class 



introduction 

The class MetaSuperClass is used to describe the superclasses from which a 
class inherits from. Instances of MetaSuperClass are always declared and 
initialized as part of an array. 

Instances of MetaSuperClass are always initialized statically and is referenced 
by a single instance of MetaClass. 

MetaClass, along with Class, Object, Message, MetaSuperClass, MetaMessage, 
and Block collectively define and implement the object-oriented properties of 
inheritance and dynamic binding (messaging) in C+O class libraries. 
Encapsulation, while supported by the above code, can be implemented by the 
programmer simply writing enough functions for a structure to obviate the 
need to access the structure members directly. These classes should be studied 
as a group to understand how C+O implements object-oriented C programs. 

For further information, read the tutorial section and also study the class 
header files dllcls.h, lelcls.h, and trecls.h. These headers define instances of 
MetaClass, MetaSuperClass and MetaMessage. 
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MetaSuperClass 



Description 

An instance of MetaSuperClass describes the name of a superclass, the type of 
the superclass, and the offset of the superclass from its subclass. 

When initializing an instance of MetaSuperClass, the name of each 
MetaSuperClass should be distinct from all other instances belonging to the 
MetaClass. 



Glossary and Special Terms 

There is no special glossary for MetaSuperClass. Instead, refer to the tutorial 
section on object-oriented techniques in C+O. 

Class Implementation MetaSuperClass 



Instance Variables 

The following is the data structure definition for a Class. 



struct MetaSuperClass { 



Mediumlnt 

PSTR 

PMCL 

POBJ 

POBJ 

Mediumlnt 



mscCheck; 

name; 

mcl; 

sublnstance; 
superlnstance; 
'offset; } 



mscCheck 

name 

mcl 

sublnstance 

superlnstance 

offset 



Uniquely identifies MetaSuperClass instances. 
Name of superclass (overrides MetaClass name). 
MetaClass which describes the class being inherited. 
An example instance of the superobject. 
An example instance of the object. 

A pointer to Mediumlnt where the superclass offset should 
be stored. 



Superclasses 

MetaSuperClass is a primitive class and has no superclasses 

Messages and Responses 

MetaSuperClass is a primitive class and has no messages 
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MetaSuperClass 



Class Variables 

MetaSuperClass has no class variables. 



Function Listing In Alphabetic Order 

Function Name Description 



Page Scope Macro 



MscGetMetaClass 


Get the MetaClass 


Msc-3 


Public 




N 


MscGetName 


Get the name of superclass 


Msc-2 


Public 




N 


MscGetOffset 


Get offset of superclass 


Msc-4 


Public 




N 


MscPrint 


Display the contents of the MetaSuperClass 


Msc-5 


Public 




N 


MscValidate 


Validate that the instance is valid 


Msc-6 


Public 




N 



Function Listing By Scope 



Public Functions 



Function Name 


Description 


Page 


Macro 


MscGetMetaClass 


Get the MetaClass 


Msc-3 


N 


MscGetName 


Get the name of superclass 


Msc-2 


N 


MscGetOffset 


Get offset of superclass 


Msc-4 


N 


MscPrint 


Display the contents of the MetaSuperClass 


Msc-5 


N 


MscValidate 


Validate that the instance is valid 


Msc-6 


N 



Private Functions 



None 









Undocumented Functions 



None 










Friend Functions 





None 
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Listing Of Functions by Category 

Query Functions 



Function Name 


Description 


Page 


Scope Macro 


MscGetMetaClass 


Get the MetaClass 


Msc-3 


Public 


N 


MscGetName 


Get the name of superclass 


Msc-2 


Public 


N 


MscGetOffset 


Get offset of superclass 


Msc-4 


Public 


N 




Debug Functions 








Function Name 


Description 


Page 


Scope Macro 


MscPrint 


Display the contents of the MetaSuperClass 


Msc-5 


Public 


N 


MscValidate 


Validate that the instance is valid 


Msc-6 


Public 


N 



Listing Of Functions With Macros Available 



None 
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Class Description for Message 



Structure Name: 



Message 
Msg 

Primitive Class 



Abbreviation: 



Class Type: 



introduction 

The Message Class is responsible for sending messages to an object and 
passing the object client to the function. This class is used only by the class 
Class. You will never need to use this class unless you are writing Class 
functions. 

MetaClass, along with Class, Object, Message, MetaSuperClass, MetaMessage, 
and Block collectively define and implement the object-oriented properties of 
inheritance and dynamic binding (messaging) in C+O class libraries. 
Encapsulation, while supported by the above code, can be implemented by the 
programmer simply writing enough functions for a structure to obviate the 
need to access the structure members directly. These classes should be studied 
as a group to understand how C+O implements object-oriented C programs. 



Description 

When an object wishes to send a message, it identifies it by a message index or 
a message selector (name). The class then selects the appropriate message to 
route the message send to. Finally, an instance of Message invokes the proper 
method with a Block instance and passes an Object pointer. 
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Glossary and Special Terms 

There is no special glossary for Message. Instead, refer to the tutorial section 
on object-oriented techniques in C+O. 

Class Implementation Message 



Instance Variables 

The following is the data structure definition for an Object 
struct Message { 



Medium I nt 
PCLS 
PMSG 
PCLS 
PSTR 
Medium Int 
PMTH 



msgCheck; 
els; 
superMsg; 
sub; 

selector; 
offset; 
method; } 



msgCheck 
els 

superMsg 
sub 

selector 
offset 



Uniquely identifies instances of Message 
Class which implements this message 
Message which is being inherited/overridden 
Class which implements this selector 
String which identifies the message 

Object offset which will yield an object of the right class for 
this message 

Function which implements this message 



method 

Superclasses 

The Message class is primitive and has no superclasses. 

Messages and Responses 

The Message class is primitive and has no messages. 

Class Variables 

The Message class has no class variables. 
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Function Listing In Alphabetic Order 



Function Name 


Description 


Page 


Scope Macro 


MsgDelnit 


Deinit instance 


Msg-2 


Public 


N 


MsgGetMethod 


Return method 


Msg -4 


Public 


N 


MsgGetOffset 


Return the object offset 


Msg -3 


Public 


N 


MsgGetSelector 


Return selector 


Msg -5 


Public 


N 


Msglnit 


Initialize instanc 


Msg-6 


Public 


N 


MsgPrint 


Print the instance 


Msg-7 


Public 


N 


MsgSend 


Send message to object 


Msg -8 


Public 


N 


MsgSendRetumlnt 


Send message to object, return int 


Msg -9 


Public 


N 


MsgSendReturnPtr 


Send message to object, return pointer 


Msg -10 


Public 


N 


MsgSetSuperOffsetAndMethod 


Override the method 


N/A 


Undoc 


N 



Function Listing By Scope 

Public Functions 



Function Name 


Description 


Page 


Macro 


MsgDelnit 


Deinit instance 


Msg-2 


N 


MsgGetMethod 


Return method 


Msg -4 


N 


MsgGetOffset 


Return the object offset 


Msg-3 


N 


MsgGetSelector 


Return selector 


Msg -5 


N 


Msglnit 


Initialize instanc 


Msg-6 


N 


MsgPrint 


Print the instance 


Msg-7 


N 


MsgSend 


Send message to object 


Msg -8 


N 


MsgSendRetumlnt 


Send message to object, return int 


Msg-9 


N 


MsgSendReturnPtr 


Send message to object, return pointer 


Msg -10 


N 


Private Functions 


None 








Undocumented Functions 






Function Name 


Description 


Page 


Macro 


MsgSetSuperOffsetAndMethod 


Override the method 


N/A 


N 
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Friend Functions 



None 









Listing Of Functions by Category 

Initialization Functions 
Function Name Description Page Scope Macro 



MsgDelnit 


Deinit instance 


Msg-2 


Public 




N 


Msglnit 


Initialize instanc 


Msg-6 


Public 




N 



Query Functions 

Function Name Description Page Scope Macro 



MsgGetMethod 


Return method 


Msg 


•4 


Public 


N 


MsgGetOffset 


Return the object offset 


Msg 


•3 


Public 


N 


MsgGetSelector 


Return selector 


Msg 


•5 


Public 


N 



Debug Functions 

Function Name Description Page Scope Macro 



MsgPrint 


Print the instance 


Msg- 


1 


Public 


N 




Object Functions 










Function Name 


Description 


Page 




Scope Macro 


MsgSend 


Send message to object 


Msg 


■8 


Public 


N 


MsgSendRetumlnt 


Send message to object, return int 


Msg- 


•9 


Public 


N 


MsgSendReturnPtr 


Send message to object, return pointer 


Msg- 


10 


Public 


N 
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Undocumented Functi ns 



Function Name 


Description 


Page 


Scope Macro 


MsgSetSuperOffsetAndMethod 


Override the method 


N/A 


Undoc 


N 


Listing Of Functions With 


Macros Available 








None 









Summary of Msg - 5 



Message 



This page intentionally left blank 



Summary of Msg - 6 



Class Description for Object 



Structure Name: 



Object 
Obj 

Primitive Class. 



Abbreviation: 



Class Type: 



Introduction 

The Object class is the conduit by which a structure gains the object-oriented 
properties of inheritance and dynamic binding. Any class which desires these 
properties must include an instance of Object as the first structure member. 

A structure which includes Object can inherit properties and messages from 
other object-oriented classes. It can be inherited by other other object-oriented 
classes. Finally, it can send messages which can be received and implemented 
by subclasses (clients) or superclasses. 

A class uses Object to retrieve client pointers, send messages, and ask 
questions about the type of the object. 

Instances of object are never created directly. Classes which include Object in 
their definition should always create instances via ClsCreateObject and destroy 
instances through ObjDestroy. A class need not initialize an Object (Objlnit) as 
this will occur automatically via ClsCreateObject. 

MetaClass, along with Class, Object, Message, MetaSuperClass, MetoMessage, 
and Block collectively define and implement the object-oriented properties of 
inheritance and dynamic binding (messaging) in C+O class libraries. 
Encapsulation, while supported by the above code, can be implemented by the 
programmer simply writing enough functions for a structure to obviate the 
need to access the structure members directly. These classes should be studied 
as a group to understand how C+O implements object-oriented C programs. 
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Description 

The function of the class Object is mainly to keep track of the instance of Class 
that is associated with this structure. The Class instance enables the Object 
instance to determine whether or not its part of a larger object and what 
messages it can respond to (and what method to call when a message is 
invoked). 

Glossary and Special Terms 

A subobject is what a subclass is to a class. It is the object instance which 
incorporates the object. 

A superobject is what a superclass is to a class. It is an object instance 
contained by an object. 

The root object is an object which has no subobject. Root objects are typically 
created by ClsCreateObject and destroyed by ObjDestroy. 

For other definitions, see the tutorial section. 

Class Implementation Object 

Superclasses 

The Object class is primitive and has no superclasses. 

Messages and Responses 

The Object class is primitive and has no messages. 

Class Variables 

The Object class has no class variables. 
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Function Listing In Alphabetic Order 



Function Name Description Page Scope Macro 



uojueimi 


ueiniuaiize instance 


UDj - c 


rUDHC 


M 
IM 


UDjuestroy 


ueiniuaiize ana deallocate ooject 


UDJ - J 


Public 


Kt 

N 


UDjueu/iieni 


neiurn a aieni 


UDJ - 4 


rUDHC 


M 
IN 


UujbetuienturNuii 


Da4i im *li Ant i* ru%n Ml II 1 

Hetum client it non-NULL 


UD) -o 


rUDHC 


N 


Uujbetus 


Hetum class 


Aki O 

Up] -o 


rUDliC 


N 


ObjGetClsName 


Return class name 


Obj-9 


Public 


N 


ObjGetlmmediateClient 


Return immediate client 


Obj - 10 


Public 


N 


ObjGetMethodAndOffset 


Return method and client offset 


Obj-11 


Public 


N 


ObjGetNthSuperObject 


Return nth superobject 


Obj -13 


Public 


N 


ObjGetRootClient 


Get root client 


Obj - 14 


Public 


N 


ObjGetRoolClientSize 


Get root object size 


Obj -15 


Public 


N 


ObjGetSize 


Get object size 


Obj -16 


Public 


N 


ObjGetSubObjectOffset 


Return offset to immediate subobject 


Obj -17 


Public 


N 


Objlnit 


Initialize object 


Obj - 18 


Public 


N 


ObjlsRoot 


Return Treu if is root subobject 


Obj -19 


Public 


N 


ObjRespondsToSelector 


Does object understand message? 


Obj -20 


Public 


N 


ObjSendMessage 


Send message to object 


Obj -21 


Public 


N 


ObjSendMessageRetumlnt 


Send message to object, return Int 


Obj-22 


Public 


N 


ObjSendMessageRetumPtr 


Send message to object, return pointer 


Obj -23 


Public 


N 



Function Listing By Scope 

Public Functions 



Function Name 


Description 


Page 


Macro 


ObjDelnit 


Deinitialize instance 


Obj-2 


N 


ObjOestroy 


Deinitjaiize and deallocate object 


Obj -3 


N 


ObjGetClient 


Return a client 


Obj -4 


N 


ObjGetClientOrNull 


Return client if non-NULL 


Obj -6 


N 


ObjGetCIs 


Return class 


Obj -8 


N 


ObjGetClsName 


Return class name 


Obj-9 


N 


ObjGetlmmediateClient 


Return immediate client 


Obj -10 


N 


ObjGetMethodAndOffset 


Return method and client offset 


Obj-11 


N 


ObjGetNthSuperObject 


Return nth superobject 


Obj -13 


N 


ObjGetRootClient 


Get root client 


Obj -14 


N 


ObjGetRootClientSize 


Get root object size 


Obj -15 


N 


ObjGetSize 


Get object size 


Obj - 16 


N 


ObjGetSubObjectOffset 


Return offset to immediate subobject 


Obj -17 


N 


Objlnit 


Initialize object 


Obj -18 


N 


ObjlsRoot 


Return Treu if is root subobject 


Obj -19 


N 
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Public Functions (cont) 



Function Name 


Description 


Page 


Macro 


ObjRespondsToSelector 


Does object understand message? 


Obj-20 


N 


ObjSendMessage 


Send message to object 


Obj-21 


N 


ObjSendMessageRetumlnt 


Send message to object, return Int 


Obj-22 


N 


ObjSendMessageRetumPtr 


Send message to object, return pointer 


Obj-23 


N 



Private Functions 



None 









Undocumented Functions 



None 



Friend Functions 



None 



Listing Of Functions by Category 

Initialization Functions 

Function Name Description Page Scope Macro 



ObjDeWt 


Deinitialize instance 


Obj-2 


Public 




N 


ObjDestroy 


Deinitialize and deallocate object 


Obj-3 


Public 




N 


Objlnit 


Initialize object 


Obj • 18 


Public 




N 
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Client Functions 



Function Name 


Description 


Page 


Scope Macro 


ObjGetClient 


Return a client 


Obj-4 


Public 


N 


ObjGetClientOrNull 


Return client if non-NULL 


Obj -6 


Public 


N 


ObjGetlmmediateClient 


Return immediate client 


Obj -10 


Public 


N 


ObjGetNthSuperObject 


Return nth superobject 


Obj -13 


Public 


N 


ObjGetRootClient 


Get root client 


Obj - 14 


Public 


N 


ObjGetSubObjectOffset 


Return offset to immediate subobject 


Obj-17 


Public 


N 



Query Functions 



Function Name 


Description 


Page 


Scope Macro 


ObjGetCIs 


Return class 


Obj -8 


Public 


N 


ObjGetClsName 


Return class name 


Obj - 9 


Public 


N 


ObjGetRootClientSize 


Get root object size 


Obj -15 


Public 


N 


ObjGetSize 


Get object size 


Obj -16 


Public 


N 


ObjlsRoot 


Return Treu if is root subobject 


Obj -19 


Public 


N 



Query Functions 



Function Name 


Description 


Page 


Scope Macro 


ObjGetMethodAndOffset 


Return method and client offset 


Obj -11 


Public 


N 


Messaging Functions 








Function Name 


Description 


Page 


Scope Macro 


ObjRespondsToSelector 


Does object understand message? 


Obj -20 


Public 


N 


ObjSendMessage 


Send message to object 


Obj -21 


Public 


N 


ObjSendMessageReturnlnt 


Send message to object, return Int 


Obj -22 


Public 


N 


ObjSendMessageReturnPtr 


Send message to object, return pointer 


Obj -23 


Public 


N 



Listing Of Functions With Macros Available 



None 
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Class Description for String 



Structure Name: 



String 
Str 



Abbreviation: 



Class Type: 



Primitive. 



Description 

The String class is used to represent and manipulate Null terminated character 
arrays and are identical to "normal" C strings. 

Some functions have been provided in this class which are available as 
functions already from the C compiler manufacturer. We have provided these 
not to insult anyone but to provide a function which maps to our naming 
convention and is perhaps more descriptive. We recognize this class is 
somewhat thin and future updates will expand the functions in this class. 

Glossary and Special Terms 

None 



Class Implementation String 



Instance Variables 

The String class is implemented as a typedef Char String. 
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Superclasses 

The String class does not inherit from any other classes. 

Class Variables 

The String class has no class instance variables. 
Function Listing In Alphabetic Order 



Function Name Description Page Scope Macro 



StrBasicExtract 


Extract a string 


N/A 


Undoc 




N 


StrExtract 


Extract string as specified 


Str-2 


Public 




N 


StrFromDate 


Fill string with a date 


Str-4 


Public 




N 


StrFrom Medium Int 


Integer to string 


Str-6 


Public 




N 


Strlnit 


Init string to zero 


Str-8 


Public 




Y 


StrReplaceSubStr 


Replace sub-string in string 


Str-9 


Public 




N 


StrSet 


Copy string to another 


Str-11 


Public 




Y 


StrSqueeze 


Removes any character from string 


Str-13 


Public 




N 


StrToDate 


Parse a date string for year, month, day 


Str-15 


Public 




N 


StrToLower 


Change case of string to lower 


Str-17 


Public 




Y 


StrToMediumlnt 


Sfr/ng to integer 


Str-19 


Public 




N 


SlrToUpper 


Change case of string to upper 


Str-21 


Public 




Y 



Function Listing By Scope 

Public Functions 



Function Name 


Description 


Page 


Macro 


StrExtract 


Extract string as specified 


Str-2 


Y 


StrFromDate 


Fill string with a date 


Str-4 


Y 


StrFrom Medium Int 


Integer to string 


Str-6 


Y 


Sir Init 


Init string to zero 


Str-8 


Y 


StrReplaceSubStr 


Replace sub-siring in string 


Str-9 


Y 


StrSet 


Copy string to another 


Str-11 


Y 


StrSqueeze 


Removes any character from string 


Str-13 


Y 


StrToDate 


Parse a date string for year, month, day 


Str-15 


Y 


StrToLower 


Change case of string to lower 


Str-17 


Y 


StrToMediumlnt 


String to integer 


Str-19 


Y 


StrToUpper 


Change case of string to upper 


Str-21 


Y 
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Private Functi ns 



None 








Function Name 


Undocumented Functions 
Description 


Page 


Macro 


StrBasicExtract 


Extract a string 


N/A 


Y 


Friend Functions 


None 









Listing Of Functions by Category 

Manipulation Functions 



Function Name 


Description 


Page 


Scope Macro 


StrBasicExtract 


Extract a string 


N/A 


Undoc 


N 


StrExtract 


Extract string as specified 


Str-2 


Public 


N 


StrReplaceSubStr 


Replace sub-string in string 


Str-9 


Public 


N 


StrSet 


Copy string to another 


Sir - 11 


Public 


Y 


StrSqueeze 


Removes any character from string 


Str-13 


Public 


N 


StrToLower 


Change case of string to lower 


Str-17 


Public 


Y 



Conversion Functions 



Function Name 


Description 


Page 


Scope Macro 


StrFromDate 


Fill string with a date 


Str-4 


Public 


N 


StrFromMediumlnt 


Integer to string 


Str-6 


Public 


N 


StrToDate 


Parse a date string for year, month, day 


Str-15 


Public 


N 


StrToMediumlnt 


String to integer 


Str-19 


Public 


N 


StrToUpper 


Change case of string to upper 


Str-21 


Public 


Y 



Summary of Str - 3 



String 



Initialization Functions 



Function Name 


Description 


Paae 


Scope Macro 


Strlnit 


Init string to zero 


Str-8 


Public 


Y 


Listing Of Functions With Macros Available 








Function Name 


Description 


Page 


Scope 




Strlnit 


Init string to zero 


Str-8 


Public 




StrSet 


Copy string to another 


Sir- 11 


Public 




StrToLower 


Change case of string to lower 


Sir- 17 


Public 




StrToUpper 


Change case of string to upper 


Sir -21 


Public 
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Class Description for Tree 



Structure Name: 
Abbreviation: 
Class Type: 



Tree 
Tre 

Inheritable class 



Introduction 

The Tree structure is organized so that items of information are related 
hierarchically by branches. This data structure is important for many 
applications such as outlining, bill of materials, parsing, and genetics. 

Description 

A tree is a finite set of one or more nodes such that: (i) there is a specially 
designated node called the root; (ii) the remaining nodes are partitioned into 
disjoint sets where each of these sets is a tree. This is a recursive definition 
and will be used in describing many of the functions throughout the reference 
section for the Tree class. 

Figure 1 shows a tree with 13 nodes. The root of the tree is node A. 




Figure 1 
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Glossary and Special Terms 

There are many terms which are used when referring to trees. The following are 
the definitions we ascribe to them. 

An instance of a Tree (or its subclass) is often called a node. It contains the 
branches to other trees. 

The number of subtrees of a tree is called its degree. In Figure 2 the degree of 
A is 3, of C is 1 and of F is zero. 

Trees of degree zero are called leaves. In Figure 2K.L and M are some of the 
leaf nodes. 

Trees with degree greater than zero are called branches. In Figure 2A.B.E, 
C, D, and H are some of the branches. 

The subtrees of a Tree X are referred to as the children of X. X is referred to as 
the parent Tree. In Figure 2 the children of D are H, I, J; the parent of D is A. 

A tree with no parent is called a root. A is the root in Figure 2. 

Children of the same parent are said to be siblings. In Figure 2 H, I and J are 
siblings. 

For a tree with children, there is a designated first child and a last child. A 
tree with one child has the same tree for the first child as its last child. 

A successor or next sibling of a tree is the immediate sibling which leads 
toward the last child of their common parent. A predecessor or previous 
sibling of a tree is the immediate sibling leading toward the first child of their 
common parent. 

The ancestors of a tree are all the trees along the path from the root to that 
tree. In Figure 2 the ancestors of M are A, D and H. 

The descendants of a tree are its children and their children and so on. In 
Figure 2 the descendants of B are E, K, L, and F. 

The siblings of a subtree tree X, are the uncles of the children of X. In Figure 2 
the trees B and C are uncles of H, I and J. 

The sequential predecessor/ successor of a tree X is found by taking (i) the 
first child if any; (ii) or the adjacent predecessor/successor sibling if any; (iii) or 
the adjacent uncle. In this way, the whole tree is traversed once (in pre-order). 
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A range of trees is defined by a beginning tree and an ending tree. Both trees 
must be siblings. The beginning tree must precede the ending tree. The range 
includes any and all elements between the beginning and ending tree. 

Examples of valid ranges in Figure 2: 

1) B through D is the subtrees B, C, and D. 2) H through H is the subtree H 
Examples of invalid ranges in in Figure 2: 

1) E through B. E and B are not siblings. 2) F through G. F and G are not 
siblings. 3) J through H. J does not precede H. 

By walking a tree, we mean we visit a subset of the nodes of the tree in a 
particular order. Visiting a node means to call a function, passing that node a 
pointer to the tree or one of its clients. 

There are many ways to walk a tree. An in-order walk of X is defined as 
performing an in-order walk of the children of X then visiting X. In Figure 2 an 
in-order walk of B would visit the nodes K, L, E, F and B in that order. 

A pre-order walk of X is defined as visiting X then performing a pre-order walk 
of the children of X. In Figure 2 a pre-order walk of B would visit the nodes E, 
F, K, and L in that order. 

The level of a tree is defined by initially letting the root be at level L, then its 
children are at level L+l and so on. Figure 2 shows the levels of the trees. 



Level 
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Class Implementation Tree 

Instance Variables 

The following is the data structure definition for a tree. 

struct Tree { Obj obj; 

Mediumlnt treCheck; 

Dll children; 

Lei siblings; } 

obj Gives Tree class object-oriented properties of inheritance and 

dynamic binding. 
treCheck Uniquely identifies Tree instances, 

children List of children, 

siblings ListElemeni in a list of siblings. 

Superclasses 

Typ e Name Description 

List Dll Children of tree 

ListElement Lei Siblings 

Messages and Responses 

Tree overrides the destroy message from its List superclass and its ListElement 
superclass. The implementation of the destroy message is handled by 
TreDestroy. Subclasses of Tree should override this message. 

Selector Method Description 

destroy TreDestroy Destroy the object 

Class Variables 

Typ e Name Description 

Mcl TreMcl Metaclass description for Tree. 

Mediumlnt TreDIIOffset Client offset of Tree from superclass Dll 

Mediumlnt TreLelOffset Client offset of Tree from superclass Lei 
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Function Listing In Alphabetic Order 



Function Name Description Page Scope Macro 



ireAsuii 


Return node as list 


Tre 


•2 


Private 


Y 


TreAsLel 


Return node as list element 


Tre 


■3 


Private 


Y 


TreAsOpi 


Return node as object 


Tre 


-4 


Private 


! y 


TreClear 


Clear the tree 


Tre 


•5 


Public 


N 


ireuient 


Return client of node 


Tre 


r* 

-6 


rv 

Public 


Y 


ireciientnndcniid 


Visit search function: children 


Tre 


-7 


Public 


N 


TreCltentRrstCnild 


Return first child node as client 


Tre 


■9 


Public 


Y 


TreClientLastCnild 


Return last child node as client 


Tre 


•11 


Public 


Y 


TreciientLastLea? 


Return last leaf node as client 


Tre 


• 13 


Public 


Y 


TreClientNext 


Return next node as client 


Tre 


•15 


Public 


Y 


TreClientNextPreOider 


Return next PreOrder client node 


Tre 


• 17 


Public 


Y 


TreClientNextUncle 


Return next uncle as client 


Tre 


•19 


Public 


Y 


TreClientParent 


Return parent node 


Tre 


■21 


Public 


Y 


ireciientPrev 


Return prev client 


Tre 


•23 


Public 


Y 


TrecnentrrevrreonJer 


Return previous client PreOrderly 


Tre 


AP 

•25 


Public 


Y 


i reoiientvisitbraricninuraer 


Visit function: branch in-order 


Tre 


•27 


Public 


N 


TreciientVisitCniioren 


Visit function: all children 


Tre 


•29 


Public 


,N 


TreciientvisitcniiarenDWd 


visit function: all children 


Tre 


•31 


Public 


N 


i reuientvisituescDrancninuraer 


Visit function: descendents 


Tre 


AA 

•33 


Public 


N 


TrA^IJArrt\/!£ > iH^A*»/*lr*^^r/lAr 

i reuiienivisiuJescinurGer 


visit tunction. oescenoents 


Tre • 


•35 


rv .Li;. 

Public 


N 


Tr 1 1 a n#\ /J c I f O a c r» 1 nf\ rrl a r Qi *v4 

i reuiicnivisiiuescinurucrDWu 


visit function, aescenoents 


ire 


•37 


PUDlIC 


N 


TrAOnAntV/icitf^ACAl ao\/oe 


visit rune lion, aescenoents 


TrA 

ire 


•39 


pnvate 


M 

N 


Xi^f^liAntV/ieifOAe^DrAOrWAr 


visn lunciton. aescenoents 


ire * 




Public 


Kt 


i reuiienivisuinuraer 


Visit function: in-order 


Tre • 


iA 

•43 


rv .u t: a 

PUtMIC 


N 


i reuiienivisiunuraerDVvu 


visit function, m-oroer 


ire * 


AC 

•45 


rv Li;. 

PUDlIC 


N 


Tfof^liontX/iciH oqv/oo 
1 tcwIrcillVloilLcaVcS 


\/ici# fi mr*ti An* Ia<3i/ac 

visii luncuon, leaves 


Tra 

ire • 


• 4/ 


rUDIIC 


M 




visii function, nearest parents first 


Tra 

ire * 


■ 49 


Di iKIJr* 

PUDlIC 


M 

N 


Tm^l S a nt\/S citD raf\ rA or 

i reuiienivisiirreuraer 


visit function, pre-oroer 


TrA 

ire • 


01 


PUDlIC 


ki 
N 


TreClientVisitRange 


Visit function: range 


Tre- 


•53 


Public 


N 


TreClientVisitSuccPreOrder 


Visit function: all successors 


Tre- 


•55 


Public 


N 


TreClientVisitSuccessors 


Visit function: successors 


Tre- 


•57 


Public 


N 


TreCutChildren 


Cut children from tree 


Tre- 


59 


Public 


Y 


TreCutRange 


Cut node(s) from tree 


Tre« 


61 


Public 


Y 


TreDelnit 


Deinitiatize Tree object 


Tre- 


63 


Public 


N 


TreDestroy 


Deinifialize Tree object and free space 


Tre- 


64 


Public 


N 


TreDestroyChildren 


Destroy any children of a tre 


Tre- 


65 


Public 


N 


TreFirstChiid 


Return first child 


Tre- 


66 


Private 


Y 


TreHasChildren 


Does node have any children 


Tre- 


68 


Public 


Y 


TreHasSiblings 


Does node have any siblings 


Tre- 


69 


Public 


Y 


Trelnit 


Initialize tree object 


Tre- 


70 


Public 


N 


TrelsChild 


Does the node have a parent 


Tre- 


71 


Public 


Y 


TrelsDirectAncestor 


Is node a direct ancester 


Tre- 


72 


Public 


N 
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Functi n Listing In Alphabetic Order (cont) 



Function Name 


Description 


Dana 

rage 


Scope Macro 


TrelsRoot 


Does the node have no parent 


i re - /o 


Public 


Y 


TreLastCnild 


Return last child 


ire - /4 


Private 


Y 


TreLastLeaf 


Return last leaf 


ire - /o 


Private 


N 


TreNext 


Return next node 


Tre -78 


Private 


Y 


TreNextPreOrder 


Return next node PreOrderly 


Tre -80 


Private 


N 


TreNextUncle 


Return next uncle 


Tre - 82 


Private 


N 


TreParent 


Return parent node 


Tre -84 


Private 


Y 


TrePasteRangeAfterSiUing 


Paste range of siblings 


Tre -86 


Public 


Y 


TrePasteRangeBeforeSibling 


Paste range of siblings 


Tre -88 


Public 


Y 


TrePasteRangeRrstChild 


Paste children 


Tre -90 


Public 


Y 


TrePasteRangeLastChild 


Paste children 


Tre -92 


Public 


Y 


TrePrev 


Return previous node 


Tre -94 


Private 


Y 


TrePrevPreOrder 


Return previous node PreOrderly 


Tre -96 


Private 


N 


TreSendDestroy 


Send message for tree destruction 


Tre - 98 


Public 


N 


TreVisitBranchlnOfder 


Visit function: branch in-order 


T-y* nn 

Tre -99 


Private 


N 


TrevisitCnildren 


Visit function: children 


ire - io i 


Private 


N 


TreVisitChildrenBwd 


Visit function: children 


4 AO 

Tre - 103 


rnvaie 


IN 


TreVisitDescBranchlnOrder 


Visit function: descendents 


Tre -105 


Private 


N 


TreVisitDescInOrder 


Visit function: descendents 


Tre -107 


Private 


N 


TreVisitDesclnOrderBwd 


Visit function: descendents 


Trfe-109 


Private 


N 


TreVisitDescPreOrder 


Visit function: descendents 


Tre-111 


Private 


N 


TreVisittnOrder 


Visit function: in-order 


Tre -113 


Private 


N 


TreVisitlnOrderBwd 


Visit function: in-order 


Tre -115 


Private 


N 


TreVisitLeaves 


Visit function: leaves 


Tre -117 


Private 


N 


TreVisitParents 


Visit function: nearest parents first 


Tre-119 


Private 


N 


TreVisitPreOrder 


Visit function: pre-order 


Tre-121 


Private 


N 


TreVisitRange 


Visit function: range 


Tre-123 


Private 


N 


TreVisitSuccPreOrder 


Visit function: all successors 


Tre -125 


Private 


N 


TreVisitSuccessofs 


Visit function: successors 


Tre-127 


Private 


N 
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Function Listing By Scope 

Public Functions 



Function Name 


Description 


Page 


Macro 


TreClear 


Clear the tree 


Tre -5 


N 


TreClient 


Return client of node 


Tre-6 


N 


TreCIientFindChild 


Visit search function: children 


Tre -7 


N 


TreClientRrstChild 


Return first child node as client 


Tre -9 


N 


TreClientLastChild 


Return last child node as client 


Tre -11 


N 


TreClientLastLeaf 


Return last leaf node as client 


Tre-13 


N 


TreClientNext 


Return next node as client 


Tre -15 


N 


TreClientNextPreOrder 


Return next PreOrder client node 


Tre- 17 


N 


TreCiientNextUncle 


Return next uncle as client 


Tre - 19 


N 


TreClientParent 


Return parent node 


Tre -21 


N 


TreClientPrev 


Return prev client 


Tre -23 


N 


TreClientPrevPreOrder 


Return previous client PreOrderly 


Tre -25 


N 


TreCfientVisitBranchlnOrder 


Visit function: branch in-order 


Tre -27 


N 


TreClientVisitChildren 


visit function: all children 


Tre -29 


N 


TreCKentVisitChildrenBwd 


Visit function: all children 


Tre -31 


N 


TreCiientVisitDescBranchlnOrder 


Visit function: descendents 


Tre -33 


N 


TreClientVisitDesclnOrder 


Visit function: descendents 


Tre -35 


N 


TreClientVisitDesclnOrderBwd 


Visit function: descendents 


Tre -37 


N 


TreClientVisitDescPreOrder 


Visit function: descendents 


Tre -41 


N 


TreClientVisitlnOrder 


Visit function: in-order 


Tre -43 


N 


TreClientVisitlnOrderBwd 


Visit function: in-order 


Tre -45 


N 


TreClientVlsitLeaves 


Visit function: leaves 


Tre -47 


N 


TreClientVisitParents 


Visit function: nearest parents first 


Tre -49 


N 


TreClientVisitPreOrder 


Visit function: pre-order 


Tre -51 


N 


Treciientvisitnange 


Visit function: range 


Tre -53 


N 


TreClientVisitSuccPreOrder 


Visit function: all successors 


Tre-55 j 


N 


TreClientVisitSuccessors 


Visit function: successors 


Tre -57 


N 


TreCutChiWren 


Cut children from tree 


Tre -59 


N 


TreCutRange 


Cut node(s) from tree 


Tre -61 


N 


TreDelnit 


Deinitialize free object 


Tre -63 


N 


TreDestroy 


Deini tialize Tree object and free space 


Tre -64 


N 


TreDestroyChildren 


Destroy any children of a tre 


Tre -65 


N 


TreHasChildren 


Does node have any children 


Tre -68 


N 


TreHasSiblings 


Does node have any siblings 


Tre -69 


N 


Trelnit 


Initialize tree object 


Tre -70 


N 


TrelsChild 


Does the node have a parent 


Tre -71 


N 


TrelsDirectAncestor 


Is node a direct ancester 


Tre -72 


N 


TrelsRoot 


Does the node have no parent 


Tre -73 


N 


TrePasteRangeAfterSibling 


Paste range of siblings 


Tre -86 


N 
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Public Functions (cont) 



Function Name 


Description 


Page 


Macro 


TrePasteRanaeBeforeSiblina 


Paste ranae of siblintis 


Tre -88 


N 


TrePasteRangeRrstChild 


Paste children 


Tre -90 


N 


TrePasteRanaeLastChild 


Paste children 


Tre -92 


N 


TreSendDestrov 


Send messaoe for tree destruction 


Tre -98 


N 




Private Functions 






Function Name 


Descriotion 


Paae 


Macro 


TreAsDII 


Return node as list 


Tre -2 


N 


TreAsLel 


Return node as list element 

I IVIUIII ■ 1 WW UW NWl VIVMIVHl 


Tre -3 


N 


TreAsObi 


Return node as obiect 

1 lv IUI III WW v»w Vwjwwl 


Tre -4 


N 


TreClientVisitDGscLeaves 


Visit function' descendants 


Tre -39 


N 


TreRrstChild 

1 Ivl IIOlwIIHW 


Return first child 

1 iwlUl 1 ■ ill wl vi li lv 


Tre -66 


N 


TreLastChild 

1 lykawlWi HIM 


Return last child 

1 IwlUl 1 1 IQwl VI II IV 


Tre -74 


N 


TreLastLeaf 


Return last leaf 


Tre -76 


N 


TreNext 


Return next node 


Tre-78 


N 


TreNextPreOrder 


Return next node PreOrderiv 


Tre-80 


N 


TreNextUnde 


Return next uncle 


Tre -82 


N 


TreParent 


Return parent node 


Tre -84 


N 


TrePrev 


Return previous node 


Tre-94 


N 


TrePrevPreOrder 


Return previous node PreOrderly 


Tre -96 


N 


TreVisitBranchlnOrder 


Visit function: branch in-order 


Tre-99 


N 


TreVisitChildren 


Visit function: children 


Tre -101 


N ! 


TreVisitChildrenBwd 


Visit function: children 


Tre - 103 


N 


TreVisitDescBranchlnOrder 


Visit function: descendents 


Tre - 105 


N 


TreVisitDesclnOrder 


Visit function: descendents 


Tre - 107 


N 


TreVisitDesclnOrderBwd 


Visit function: descendents 


Tre-109 


N 


TreVisitDescPreOrder 


Visit function: descendents 


Tre -111 


N 


TreVisitlnOrder 


Visit function: in-order 


Tre-113 


N 


TreVisitlnOrderBwd 


Visit function: in-order 


Tre -115 


N 


TreVisitLeaves 


Visit function: leaves 


Tre -117 


N 


TreVisitParents 


Visit function: nearest parents first 


Tre -119 


N 


TreVisitPreOrder 


Visit function: pre-order 


Tre -121 


N 


TreVisitRange 


Visit function: range 


Tre -123 


N 


TreVisitSuccPreOrder 


Visit function: all successors 


Tre-125 


N 


TreVisitSuccessors 


Visit function: successors 


Tre -127 


N 
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Undocum nted Functi ns 



None 








Friend Functions 


None 









Listing Of Functions by Category 

Superclass Functions 



Function Name 


Description 


Page 


Scope Macro 


TreAsDII 


Return node as list 


Tre-2 


Private 


Y 


TreAsLel 


Return node as list element 


Tre-3 


Private 


Y 


TreAsObj 


Return node as object 


Tre-4 


Private 


Y 




Edit Functions 








Function Name 


Description 


Page 


Scope Macro 


TreClear 


Clear the tree 


Tre-5 


Public 


N 


TreCutChildren 


Cut children from tree 


Tre-59 


Public 


Y 


TreCutRange 


Cut node(s) from tree 


Tre-61 


Public 


Y 


TrePasteRangeAfterSibling 


Paste range of siblings 


Tre-86 


Public 


Y 


TrePasteRangeBeforeSibling 


Paste range of siblings 


Tre-88 


Public 


Y 


TrePasteRangeFirstChild 


Paste children 


Tre-90 


Public 


Y 


TrePasteRangeLastChild 


Paste children 


Tre-92 


Public 


Y 
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Query Functions 



Function Name Description Page Scope Macro 



TreClient 


Return client of node 


Tre 


•6 


Public 


Y 


TreClientRndChild 


Visit search function: children 


Tre 


•7 


Public 


N 


TreClientRrstChild 


Return first child node as client 


Tre 


-9 


Public 


Y 


TreClientLastChild 


Return last child node as client 


Tre 


•11 


Public 


Y 


TreClientLastLeaf 


Return last leaf node as client 


Tre 


-13 


Public 


Y 


TreClientNext 


Return next node as client 


Tre 


•15 


Public 


Y 


TreClientNextPreOrder 


Return next PreOrder client node 


Tre- 


•17 


Public 


Y 


TreClientNextUncle 


Return next uncle as client 


Tre 


-19 


Public 


Y 


TreClientParent 


Return parent node 


Tre 


•21 


Public 


Y 


TreClientPrev 


Return prev client 


Tre 


■23 


Public 


Y 


TreClientPrevPreOfder 


Return previous client PreOrderly 


Tre- 


•25 


Public 


Y 


TreRrstChild 


Return first child 


Tre- 


■66 


Private 


Y 


i renasoniiaren 


uoes nooe nave any cniioren 


Tro 
lie 


. Oft 


Pnhlir 
rUDIIC 


Y 
T 


TreHasSiWings 


Does node have any siblings 


Tre 


•69 


Public 


Y 


TrelsChild 


Does the node have a parent 


Tre 


■71 


Public 


Y | 


TrelsDirectAncestor 


Is node a direct ancester 


Tre- 


•72 


Public 


N 


TrelsRoot 


Does the node have no parent 


Tre- 


■73 


Public 


Y 


TreLastChiid 


Return last child 


Tre- 


•74 


Private 


Y 


TreLastLeaf 


Return last leaf 


Tre- 


•76 


Private 


N 


TreNext 


Return next node 


Tre- 


•78 


Private 


Y 


TreNextPreOrder 


Return next node PreOrderly 


Tre- 


•80 


Private 


N 


TreNextUnde 


Return next uncle 


Tre- 


-82 


Private 


N 


TreParent 


Return parent node 


Tre- 


•84 


Private 


Y 


TrePrev 


Return previous node 


Tre 


-94 


Private 


Y 


TrePrevPreOrder 


Return previous node PreOrderly 


Tre- 


•96 


Private 


N 
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Visit Functi ns 



Function Name Description Page Scope Macro 



TreClientVisitBranchlnOrder 


Visit function: branch in-order 


Tre 


-27 


Public 


N 


TreClientVisitChildren 


Visit function: ail children 


Tre 


-29 


Public 


N 


TreClientVisitChildrenBwd 


Visit function: all children 


Tre 


-31 


Public 


N 


TreClientVisitDescBranchlnOrder 


Visit function: descendents 


Tre 


-33 


Public 


N 


TreClientVisitDesclnOrder 


Visit function: descendents 


Tre 


-35 


Public 


N 


TreCIientVisitDesclnOrderBwd 


Visit function: descendents 


Tre 


-37 


Public 


N 


TreClientVisitOescLeaves 


Visit function: descendents 


Tre 


-39 


Private 


N 


TreClientVisitDescPreOrder 


Visit function: descendents 


Tre 


-41 


Public 


N 


TreCiientVisitlnOrder 


Visit function: in-order 


Tre 


-43 


Public 


N 


TreClientVisitlnOrderBwd 


Visit function: in-order 


Tre 


•45 


Public 


N 


TreClientVlsitLeaves 


Visit function: leaves 


Tre 


-47 


Public 


N 


TreClientVisitParents 


Visit function: nearest parents first 


Tre 


■49 


Public 


N 


TreClientVisitPreOrder 


Visit function: pre-order 


Tre« 


•51 


Public 


N 


TreClienMsitRange 


Visit function: range 


Tre 


-53 


Public 


N 


TreCiientVisitSuccPreOrder 


Visit function: all successors 


Tre- 


■55 


Public 


N 


TreClientVlsitSuccessors 


Visit function: successors 


Tre- 


•57 


Public 


N 


TreVisitBranchlnOrder 


Visit function: branch in-order 


Tre- 


99 


Private 


N 


TreVisitChildren 


Visit function: children 


Tre- 


101 


Private 


N 


TreVisitChildrenBwd 


Visit function: children 


Tre- 


103 


Private 


N 


TreVisitDescBranchlnOrder 


Visit function: descendents 


Tre- 


105 


Private 


N 


TreVisitDesclnOrder 


Visit function: descendents 


Tre- 


107 


Private j 


N 


TreVisitDesclnOrderBwd 


Visit function: descendents 


Tre- 


109 


Private 


N 


TreVisitDescPreOrder 


Visit function: descendents 


Tre- 


111 


Private 


N 


TreVisitlnOrder 


Visit function: in-order 


Tre- 


113 


Private 


N 


TreVisitlnOrderBwd 


Visit function: in-order 


Tre- 


115 


Private 


N 


TreVisitLeaves 


Visit function: leaves 


Tre- 


117 


Private 


N 


TreVisitParents 


Visit function: nearest parents first 


Tre- 


119 


Private 


N 


TreVisitPreOrder 


Visit function: pre-order 


Tre- 


121 


Private 


N 


TreVisitRange 


Visit function: range 


Tre- 


123 


Private 


N 


TreVisitSuccPreOrder 


Visit function: all successors 


Tre- 


125 


Private 


N 


TreVisitSuccessors 


Visit function: successors 


Tre- 


127 


Private 


N 



Initialization Functions 
Function Name Description Page Scope Macro 



TreDelnit 


Deinitialize Tree object 


Tre 


-63 


Public 


N 


TreDestroy 


Deinitialize Tree object and free space 


Tre 


•64 


Public 


N 


TreDestroyChildren 


Destroy any children of a tre 


Tre 


■65 


Public 


N 


Trelnit 


Initialize tree object 


Tre 


■70 


Public 


N 


TreSendDestroy 


Send message for tree destruction 


Tre- 


•98 


Public 


N 
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Listing Of Functions With Macros Available 



Function Name 


uescnpuon 


Pan 
ray 


a 

6 


Scone 


TreAsDll 


DaIi irn r*/\fif\ lief 

neturn noae as usi 


Tre 


.0 

c 


Private 

r 1 ivai6 


TreAsLel 


neturn nooe as usi element 


Trp 
1 16 


. Q 
w 


Private 


TreAsObj 


neturn nooe as ouject 


Tre 

1 16 


- 4 


Private 


TreCiient 


neium ctiew oi i kajc 


Tre 


-6 

V 


Public 


TreClientRrstChiid 


neturn nrsi cnna noae as ciiem 


Trp 

1 16 


.0 


Puhiir 


TreClientLastcnnd 


ne turn lasi crwo noae as cueni 


Trp 
1 16 


. 11 


Public 


TreClientLastLeaf 


□ah im lact loaf nnrio ac Hiont 


Tre 

1 16 


- 13 


Public 


TreClientNext 


Heturn next nooe as client 


Trp 
1 16 


10 


Plihiir 


TreClientNextPreOrder 


Return next preuroer cuent noae 


ire 


- 17 


Pi thlto 


TreClientNextUncte 


Return next uncie as client 


Tro 

116 




Pi ihK/* 


TreClientParent 


Return parent node 


ire 


91 


rUUlKJ 


TreClientPrev 


Return prev cuent 


Trp 

1 16 




Public 


TreClientPrevPreuraer 


neturn previous cuem rrewrucuy 


Tre 

1 16 




Public 


T«Av^l l^klMMH 

TreCutcniidren 


out cnuoren irom uee 


Tre 

1 16 




Public 


TrecutRange 


uux noue\S/ irum iree 


Tre 

1 16 


• 61 

O 1 


Public 


TrerirstCniid 


neturn nrsi cniia 


Tre 

1 16 


-66 


Private 


TreHasChildren 


Does node have any children 


Tre 


-68 


Public 


TreHasSiblings 


Does node have any siblings 


Tre 


-69 


Public 


TrelsChild 


Does the node have a parent 


Tre 


-71 


Public 


TrelsRoot 


Does the node have no parent 


Tre 


-73 


Public 


TreLastChild 


Return last child 


Tre 


-74 


Private 


TreNexl 


Return next node 


Tre 


-78 


Private 


TreParent 


Return parent node 


Tre 


-84 


Private 


TrePasteRangeAfterSibling 


Paste range of siblings 


Tre 


-86 


Public 


TrePasteRangeBeforeSibling 


Paste range of siblings 


Tre 


-88 


Public 


TrePasteRangeFirstChild 


Paste children 


Tre 


-90 


Public 


TrePasteRangeLastChild 


Paste children 


Tre 


-92 


Public 


TrePrev 


Return previous node 


Tre 


-94 


Private 
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Class Description for Task 



Structure Name: 



Task 



Abbreviation: 



Tsk 



Class Type: 



Primitive Class 



Introduction 

The Task class models the program being executed. Currently its major usage 
is to handle exceptions that may arise during program execution. A task may 
set up any number of exception handlers for intercepting exceptions that are 
raised by a program. C+O class libraries include a debug library which checks 
parameter input to functions scrupulously, generating exceptions if the 
parameter is invalid. 

Description 

The first call in a C+O program should be a call to Tsklnit or TskDefaultlnit. 
Most, if not all, programs should initialize the pre-defined global TskMain. 
Once a task has been initialized, a call should be made to TskOnException. 
This sets up an exception handler for the program which will catch many 
program logic errors, especially calls to C+O. 

Glossary and Special Terms 

No special glossary exists for this class. 
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Class Implementation Task 



Instance Variables 



The following is the data structure definition for Task. 



struct Task { 



Mediumlnt 
Mediumlnt 
PSTR 
Dpa 

Mediumlnt 

PSTR 

Mediumlnt 

Mediumlnt 

ExceptionType 

ExcFilter 



tskCheck; 

argc; 

*argv; 

exhStack; 

current; 

fiieName; 

lineNo; 

condition; 

type; 
defExcFilter; } 



tskCheck 

argc 

*argv 

exhStack 

current 

fiieName 

lineNo 

condition 

defExcFilter 

Superclasses 



Uniquely identifies Task instances. 

Argc from mainQ. 

Argv from main(). 

Stack of exception handlers. 

Active exception handler index. 

File which invoked exception. 

line number in file which invoked exception. 

Condition value at time of exception. 

Type of exception. 

Filter for exception handler. 



None 

Messages and Responses 

None 

Class Variables 

Typ e Name 

Task TskMain 



Description 

The default task for the program 
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Function Listing In Alphabetic Order 



Function Name Description Page Scope Macro 



TskBasicAssert 


Foundation function 


N/A 




Undoc 


N 


TskCondition 


Raise exception conditionally 


Tsk 


•2 


Public 


N 


TskDelnit 


Deinitialize instance 


Tsk 


■4 


Public 


N 


TskDefaultlnit 


Initialize instance with defaults 


Tsk 


•5 


Public 


N 


TskExit 


Exit program with code 


Tsk 


-6 


Public 


N 


TskExitWithMsg 


Exit program and print message 


Tsk 


•7 


Public 


N 


TskGetArgc 


Get mainQ argument count 


Tsk 


■8 


Public 


N 


TskGetArgv 


Get main() argument vector 


Tsk- 


•9 


Public 


N 


TskGetExceptionCondition 


Return exception condition 


Tsk 


•10 


Public 


N 


TskGetExceptionFileName 


Return filename of exception 


Tsk- 


•11 


Public 


N 


TskGetExceptionLineNo 


Return exception line number 


Tsk 


•12 


Public 


N 


TskGetExceptionType 


Return exception type 


Tsk- 


•13 


Public 


N 


Tsklnit 


Initialize instance 


Tsk- 


•15 


Public 


N 


Tsklslnitialized 


Is the Task initialized 


N/A 




Undoc 


N 


TskLogCond 


Raise exception conditionally 


Tsk- 


•17 


Public 


N 


TskMainLonCond 


Raicp pyf pntirtn mnrlttinn^llv 

nCMOv CAOCpUUl 1 Wl iUJUUI hXuj 




. 1Q 
• IB 


Pi iKIi a 

rUDllC 


M 
IN 


TskMainPreCond 


Raise exception conditionally 


Tsk- 


21 


Public 


N 


TskMainPtrCond 


Raise exception conditionally 


Tsk- 


•23 


Public 


N 


TskMainRaiseException 


Raise exception unconditionally 


Tsk- 


25 


Public 


N 


TskNormalExit 


Exit task normally 


Tsk- 


27 


Public 


N 


TskOnException 


Establish exception handler 


Tsk- 


28 


Public 


N 


TskPopExceptionHandler 


Pop exception handler 


Tsk- 


30 


Public 


N 


TskPreCond 


Raise exception conditionally 


Tsk- 


32 


Public 


N 


TskPrintException 


Print description of exception 


Tsk- 


34 


Public 


N 


TskPropagateException 


Pass last exception 


Tsk- 


36 


Public 


N 


TskPtrCond 


Raise exception conditionally 


Tsk- 


38 


Public 


N 


TskPushExh 


Push the exception 


N/A 




Undoc 


N 


TskRaiseException 


Raise exception unconditionally 


Tsk- 


40 


Public 


N 
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Function Listing By Scope 

Public Functions 



Function Name 


Description 


Page 


Macro 


TskCondition 


Raise exception conditionally 


Tsk-2 


N 


TskDelnit 


Deinitialize instance 


Tsk-4 


N 


TskOefauItlnit 


Initialize instance with defaults 


Tsk-5 


N | 


TskExit 


Exit program with code 


Tsk-6 


N 


TskExitWithMsg 


Exit program and print message 


Tsk-7 


N 


TskGetArgc 


Get main() argument count 


Tsk-8 


N 


TskGetArgv 


Get mainO argument vector 


Tsk-9 


N 


TskGetExceptionCondition 


Return exception condition 


Tsk-10 


N 


TskGetExceptionFileName 


Return filename of exception 


Tsk-11 


N 


TskGetExceptionLineNo 


Return exception line number 


Tsk-12 


N 


TskGetExceptionType 


Return exception type 


Tsk-13 


N 


1 ofvlilll 


Initial I70 inctanro 


Tsk- 15 


N 


TskLogGond 


Raise exception conditionally 


Tsk- 17 


N 


TskMainLogCond 


Raise exception conditionally 


Tsk- 19 


N 


TskMainPreCond 


Raise exception conditionally 


Tsk -21 


N 


TskMainPtrCond 


Raise exception conditionally 


Tsk -23 


N 


TskMainRaiseException 


Raise exception unconditionally 


Tsk -25 


N 


TskNormalExit 


Exit task normally 


Tsk -27 


N 


TskOnException 


Establish exception handler 


Tsk -28 


N 


TskPopExceptionHandler 


Pop exception handler 


Tsk -30 


N 


TskPreCond 


Raise exception conditionally 


Tsk -32 


N 


TskPrintExeeption 


Print description of exception 


Tsk-34 


N 


TskPropagateException 


Pass last exception 


Tsk -36 


N 


TskPtrCond 


Raise exception conditionally 


Tsk -38 


N 


TskRaiseException 


Raise exception unconditionally 


Tsk -40 


N 


Private Functions 


None 








Undocumented Functions 






Function Name 


Description 


Page 


Macro 


TskBasicAssert 


Foundation function 


N/A 


N 


Tsklslnitialized 


Is the TasAc initialized 


N/A 


N 


TskPushExh 


Push the exception 


N/A 


N 
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Friend Functi ns 



None 









Listing Of Functions by Category 

Undocumented Functions 

Function Name Description Page Scope Macro 



TskBasfcAssert 


Foundation function 


N/A 


Undoc 


N 


Tsklslnitialized 


Is the Task initialized 


N/A 


Undoc 


N 


TskPushExh 


Push the exception 


N/A 


Undoc 


N 


Exception Functions 








Function Name 


Description 


Page 


Scope Macro 


TskCondition 


Raise exception conditionally 




Public 


N 


TskLogCond 


Raise exception conditionally 


Tsk-17 


Public 


N 


TskMainLogCond 


Raise exception conditionally 


Tsk-19 


Public 


N 


TskMainPreCond 


Raise exception conditionally 


Tsk-21 


Public 


N 


TskMainPtrCond 


Raise exception conditionally 


Tsk-23 


Public 


N 


TskMainRaiseException 


Raise exception unconditionally 


Tsk-25 


Public 


N 


TskOnException 


Establish exception handler 


Tsk-28 


Public 


N 


TskPopExceptionHandler 


Pop exception handler 


Tsk-30 


Public 


N 


TskPreCond 


Raise exception conditionally 


Tsk-32 


Public 


N 


TskPrintException 


Print description of exception 


Tsk-34 


Public 


N 


TskPropagateException 


Pass last exception 


Tsk-36 


Public 


N 


TskPtrCond 


Raise exception conditionally 


Tsk-38 


Public 


N 


TskRaiseException 


Raise exception unconditionally 


Tsk-40 


Public 


N 


Initialization Functions 








Function Name 


Description 


Page 


Scope Macro 


TskDelnit 


Deinitialize instance 


Tsk-4 


Public 


N 


TskDefaultlnit 


Initialize instance with defaults 


Tsk-5 


Public 


N 


Tsklnit 


Initialize instance 


Tsk-15 


Public 


N 
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Task 



Exit Functions 



Function Name 


Description 


Page 


Scope Macro 


TskExit 


Exit program with code 


Tsk-6 


Public 


N 


TskExitWithMsg 


Exit program and print message 


Tsk-7 


Public 


N 


TskNormalExit 


Exit task normally 


Tsk-27 


Public 


N 




Query Functions 








Function Name 


Description 


Page 


Scope Macro 


TskGetArgc 


Get main() argument count 


Tsk-8 


Public 


N 


TskGetArgv 


Get mainQ argument vector 


Tsk-9 


Public 


N 


TskGetExceptionCondition 


Return exception condition 


Tsk-10 


Public 


N 


TskGetExceptionRleName 


Return filename of exception 


Tsk-11 


Public 


N 


TskGetExceptionUneNo 


Return exception line number 


Tsk-12 


Public 


N 


TskGetExceptionType 


Return exception type 


Tsk-13 


Public 


N 



Listing Of Functions With Macros Available 



None 
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Class Description for Vertex 



Structure Name: Vertex 

Abbreviation: Vtx 

Class Type: Inheritable class 



Introduction 

A Vertex must be used in combination with Graph and Edge to be of any value. 
A Vertex can model among other things, activities in a critical path network, 
cities connected by highways, cells in a spreadsheet, etc. 

The Vertex class has two friend classes Edge and Graph. The documentation for 
the Vertex class should therefore be read in conjunction with the classes Edge 
and Graph. 

Description 

A vertex can have incoming edges and outgoing edges. In Figure 1 below the 
vertex A has an incoming edge x, and an outgoing edge y. 



Glossary and Special Terms 

The successor vertices of a Vertex & are the vertices at the head of the 
outgoing edges of A. The predecessor vertices of A are the vertices at the tail 
end of the incoming edges of A. See Figure 1. 



Incoming Edge 




Outgoing Edge 
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Class Implementation Vertex 



Instance Variables 

The following is the data structure definition for a vertex in a directed graph. 



struct Vertex { 



Obj 

Medium Int 

Lei 

Dll 

Dll 



object; 
vtxCheck; 
graph; 
inUst; 
outList; }; 



obj 

vtxCheck 
graph 
inList 
outList 

Superclasses 
Type 

ListElement 

List 

Ust 



Gives Vertex class object-oriented properties of inheritance 

and dynamic binding. 

Uniquely identifies Vertex instances. 

List element in a graph. 

List of incoming edges. 

List of outgoing edges. 



Name 

GrfLel 

InDII 

OutDII 



Description 

Graph membership 
List of incoming edges 
List of outgoing edges 



Messages and Responses 

Vertex overrides the destroy message from both of its List superclasses and its 
ListElement superclass. The implementation of the destroy message is handled 
by VtxDestroy. The subclass of Vertex should override this method. 

Selector Method Description 

destroy VtxDestroy Destroy the object 
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Vertex 



Class Variables 

Ty pe Name Description 

Mcl VtxMcl Metaclass decription for Vertex. 

Mediumlnt VtxInDIIOffset Client offset of Vertex from superclass 

InDII. 

Mediumlnt VtxOutDIIOffset Client offset of Vertex from superclass 

OutDII. 

Mediumlnt VtxGrfLelOffset Client offset of Vertex from superclass 

GrfLel. 



Function Listing In Alphabetic Order 



Function Name 


Description 


Page 


Scope Macro 


VtxAsGrfLel 


Return list element in graph 


Vtx-2 


Friend 


Y 


VtxAstnDII 


Return vertex as Bst of incoming edges 


Vtx-3 


Friend 


N 


VtxAsObj 


Return edge as object 


Vtx-4 


Private 


N 


VtxAsOutDII 


Return vertex as list of outgoing edges 


Vtx-5 


Friend 


N 


VtxClear 


Clear vertex 


Vtx-6 


Public 


N 


VtxConnectToGrf 


Connect vertex to graph 


Vtx-7 


Public 


N 


VtxCountln 


Count incoming edges 


Vtx-9 


Public 


Y 


VtxCountOut 


Count outgoing edges 


Vtx-11 


Public 


Y 


VtxDelnit 


Deinitialize the Vertex object 


Vtx-13 


Public 


N 


VtxDestroy 


Deinib'alize Vertex object and free space 


Vtx-14 


Public 


N 


VtxDisconnectFromGrf 


Disconnect vertex from graph 


Vtx-15 


Public 


Y 


VtxFindOutEdg 


Visit search function: outgoing edges 


Vtx-17 


Private 


N 


VtxRndOutEdgClient 


Visit search function: outgoing edges 


Vtx-19 


Public 


N 


VtxGetClient 


Return client of vertex 


Vtx-21 


Public 


Y 


VtxGetFirstln 


Return first incoming edge 


VtX-22 


Public 


Y 


VtxGetRrstOut 


Return first outgoing edge 


Vtx-23 


Public 


Y 


VtxGetGrf 


Return graph 


Vtx-24 


Friend 


Y 


VtxInGrf 


Is vertex in graph 


Vtx-26 


Public 


Y 


Vtxlnit 


Initialize the Vertex object 


Vtx-25 


Public 


N 


VtxSend Destroy 


Send message for vertex destruction 


Vtx-27 


Public 


N 


VtxStackSetup 


Set up values for topsort 


Vtx-28 


Friend 


Y 


VtxVisitEdge 


Visit function: each edge 


Vtx-29 


Friend 


N 


VtxVisitEdgeClient 


Visit function: each edge 


Vtx-31 


Public 


N 


VtxVisitlnEdge 


Visit function: incoming edge 


Vtx-33 


Friend 


N 


VtxVisitlnEdgeClient 


Visit function: incoming edge 


Vtx-35 


Public 


N 


VtxVisitOutEdge 


Visit function: outgoing edge 


Vtx-37 


Friend 


N 


VtxVisitOutEdgeaient 


Visit function: outgoing edge 


Vtx-39 


Public 


N 
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Function Listing By Scope 

Public Functions 



Pnn/*Mnn Mam a 
runwuun name 




Pane 


Macro 


V lAV/lOCU 


Clear vertex 


Vtx-6 


N 


VtxCAnnPCtTofirf 

V lAVvl II ICwl 1 Vvil 1 


Connect vertex to araoh 


Vlx-7 


N 


V lAVUUI llli 1 


Co i int irraminn edne<i 

vvui ii u ivwi i iii iy cuyuo 


Vtx-9 


N 


VtxCountOut 


Count outgoing edges 


Vtx-11 


N 


VtxDelnit 


Deinitialize the Vertex object 


Vtx-13 


N 


VtxDestroy 


Deinitiafize Vertex object and free space 


Vtx-14 


N 


VtxDisconnectFromGrf 


Disconnect vertex from graph 


Vtx-15 


N 


VtxRndOutEdgQient 


Visit search function: outgoing edges 


Vtx-19 


N 


VtxGetClient 


Return client of vertex 


Vtx-21 


N 


VtxGetFirstln 


Return first incoming edge 


Vtx-22 


N 


X/tYftotPirctfti it 
V Kv3t? IT II olLAJ 1 




Vtx-23 


N 


VtxInGrf 


Is vertex in graph 


Vtx-26 


N 


Vtxlnit 


Initialize the Vertex object 


Vtx-25 


N 


VtxSendDestroy 


Send message for vertex destruction 


Vlx-27 


N 


VtxVisitEdgeaient 


Visit function: each edge 


Vtx-31 


N 


VixVisitlnEdgeCaent 


Visit function: incoming edge 


Vtx-35 


N 


VtxVisitOutEdgeaient 


Visit function: outgoing edge 


Vtx-39 


N 




Private Functions 






Function Name 


Description 


Page 


Macro 


VtxAsObj 


Return edge as object 


Vlx-4 


N 


VtxRndOutEdg 


Visit search function: outgoing edges 


Vtx-17 


N 



Undocumented Functions 



None 









Summary of Vtx- 4 



Vertex 



Friend Functions 



Function Name 


Description 


Page 


Macro 


VtxAsGrfLel 


Return list element in graph 


Vtx-2 


N 


VtxAslnDII 


Return vertex as list of incoming edges 


Vtx-3 


N 


VtxAsOutDO 


Return vertex as list of outgoing edges 


Vtx-5 


N 


VtxGetGrf 


Return graph 


Vtx-24 


N 


VtxStackSetup 


Set up values for topsort 


Vtx-28 


N 


VtxVisitEdge 


Visit function: each edge 


Vtx-29 


N 


VtxVisitlnEdge 


Visit function: incoming edge 


Vlx-33 


N 


VtxVisitOutEdge 


Visit function: outgoing edge 


Vtx-37 


N 



Listing Of Functions by Category 

Superclass Functions 



Function Name 


Description 


Page 


Scope Macro 


VtxAsGrfLel 


Return list element in graph 


Vtx-2 


Friend 


Y 


VtxAslnDII 


Return vertex as list of incoming edges 


Vtx-3 


Friend 


N 


VtxAsObj 


Return edge as object 


Vtx-4 


Private 


N 


VtxAsOutDII 


Return vertex as list of outgoing edges 


Vtx-5 


Friend 


N 




Edit Functions 








Function Name 


Description 


Page 


Scope Macro 


VtxClear j 


Clear vertex 


Vtx-6 


Public 


N 


VtxConnectToGrf 


Connect vertex to graph 


Vtx-7 


Public 


N 


VtxDisconnectFromGrf 


Disconnect vertex from graph 


Vtx-15 ! 


Public 


Y 
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Query Functions 



Function Name 


Description 


Page 


Scope Macro 


VtxCounttn 


Count incoming edges 


Vtx-9 


Public 


Y 


VtxCountOut 


Count outgoing edges 


Vtx-11 


Public 


Y 


VtxFindOutEdg 


Visit search function: outgoing edges 


Vtx-17 


Private 


N 


VtxRndOutEdgClienl 


Visit search function: outgoing edges 


Vtx-19 


Public 


N 


VtxGetCiient 


Return client of vertex 


Vtx-21 


Public 


Y 


VtxGetFirstln 


Return first incoming edge 


Vtx-22 


Public 


Y 


VtxGetRrstOut 


Return first outgoing edge 


Vtx-23 


Public 


Y 


VtxGetGrf 


Return graph 


Vtx-24 


Friend 


Y 


VtxInGrf 


Is vertex in graph 


Vtx-26 


Public 


Y 


VtxStackSetup 


Set up values for topsort 


Vtx-28 


Friend 


Y 



Initialization Functions 



Function Name 


Description 


Page 


Scope Macro 


VtxDelnit " 


Deinitialize the Vertex object 


Vtx-13 


Public 


N 


VtxDestroy 


Oeinitialize Vertex object and free space 


Vtx-14 


Public 


N 


Vtxlnit 


Initialize the Vertex object 


Vbc-25 


Public 


N 


VtxSendDestroy 


Send message for vertex destruction 


Vtx-27 


Public 


N 




Visit Functions 








Function Name 


Description 


Page 


Scope Macro 


VtxVisitEdge 


Visit function: each edge 


Vtx-29 


Friend 


N 


VtxVisitEdgedient 


Visit function: each edge 


Vtx-31 


Public 


N 


VtxVisitlnEdge 


Visit function: incoming edge 


Vtx-33 


Friend 


N 


VtxVisitlnEdgeClient 


Visit function: incoming edge 


Vtx-35 


Public 


N 


VtxVisitOutEdge 


Visit function: outgoing edge 


Vtx-37 


Friend 


N 


VtxVisitOutEdgeClient 


Visit function: outgoing edge 


Vtx-39 


Public 


N 



Summary of Vtx - 6 



Vertex 



Listing Of Functions With Macros Available 



Function Name Description Page Scope 



VtxAsGrfLel 


Return list element in graph 


Vtx 


•2 


Friend 


VtxCountln 


Count incoming edges 


Vtx 


•9 


Public 


VtxCountOut 


Count outgoing edges 


Vtx 


■11 


Public 


VtxDisconnectFromGrf 


Disconnect vertex from graph 


Vtx 


■15 


Public 


VtxGetClient 


Return client of vertex 


Vtx 


•21 


Public 


VtxGetRrstin 


Return first incoming edge 


Vtx 


■22 


Public 


VtxGetFirstOut 


Return first outgoing edge 


Vtx 


•23 


Public 


VtxGetGrf 


Return graph 


Vtx. 


•24 


Friend 


VtxInGrf 


Is vertex in graph 


Vtx- 


26 


Public 


VtxStackSetup 


Setup values for topsort 


Vtx- 


28 


Friend 
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Class Exceptions Reference 



BlkClear( pBlk ) 

BLK - 65: pBlk must be a valid Blk pointer. 

BlkDeInit( pBlk ) 

BLK - 89: pBlk must be a valid Blk pointer. 

BLK - 91: pBlk must be a valid Blk pointer. 

BlkExecute( pBlk, pObj ) 

BLK - 1 15: pBlk must be a valid Blk pointer. 

BLK - 1 16: pBlk must contain a non Null method pointer. 

BlkExecuteRetBooK pBlk, pObj ) 

BLK - 156: pBlk must be a valid Blk pointer. 

BLK - 157: pBlk must contain a non Null method pointer. 

BlkExecuteRetDataPtr( pBlk, pObj ) 

BLK - 197: pBlk must be a valid Blk pointer. 

BLK - 198: pBlk must contain a non Null method pointer. 

BlkExecuteRetFuncPtrC pBlk, pObj ) 

BLK - 238: pBlk must be a valid Blk pointer. 

BLK - 239: pBlk must contain a non Null method pointer. 

BlkExecuteRetInt( pBlk, pObj ) 

BLK - 279: pBlk must be a valid Blk pointer. 

BLK - 280: pBlk must contain a non Null method pointer. 



Appendix A - 1 



Class Exceptions Reference 



BlkHasMethod( pBlk ) 

BLK - 317: pBlk must be a valid Blk pointer. 

Blklnit( pBlk,pMth) 

BLK - 343: pBlk must be a valid Blk pointer. 

BlkPrint( pBlk, pCio, item, level, name ) 

BLK - 380: pBlk must be a valid Blk pointer. 

BLK - 381: pCio must be a valid Go pointer. 

BlkPushDataPtr( pBlk, p ) 

BLK - 410: pBlk must be a valid Blk pointer. 

BLK -411: The total number of parameters must not be larger than the 

parameter array. 

BlkPushFuncPtr( pBlk, p ) 

BLK - 441: pBlk must be a valid Blk pointer. 

BlkPushLargeInt( pBlk, p ) 

BLK - 470: pBlk must be a valid Blk pointer. 

BLK - 471: The total number of parameters must not be larger than the 

parameter array. 



BlkPushMediumInt( pBlk, p ) 



BLK - 497: pBlk must be a valid Blk pointer. 

BLK - 498: The total number of parameters must not be larger than the 

parameter array. 



BlkSetMethod( pBlk, pMth ) 



BLK - 524: pBlk must be a valid Blk pointer. 

BLK - 525: pMth must be a valid Blk pointer. 
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Class Exceptions Reference 



ClsCreateMessages( pCls ) 



CLS -97: 



pCis must be a valid CIs pointer. 



ClsCreateObject( pCls ) 



CLS-141 
CLS-142: 
CLS - 145 



pCls must be a valid CIs pointer. 

The class must not have any sub-classes. 

Not enough memory to create object 



ClsCreateObjectFast( pCls ) 



CLS - 197: 
CLS -198; 
CLS -201 



pQs must be a valid CIs pointer. 

The class must not have any sub-classes. 

Not enough memory to create object 



ClsCreateSupers( pCls ) 

CLS -233: 



pCls must be a valid CIs pointer. 



ClsDelnitC pCls ) 



CLS -268: 
CLS -272: 



pCls must be a valid CIs pointer. 
pCls must be a valid CIs pointer. 



ClsDestroy( pCls ) 



CLS -305: 



pQs must be a valid CIs pointer. 



ClsDestroyMessages( pCls ) 



CLS - 334: 



pCls must be a valid CIs pointer. 



ClsDestroyObject( pCls, pObj ) 



CLS -370: 
CLS -371 
CLS - 372: 



pCls must be a valid CIs pointer. 

pObj must be a valid Obj pointer. 

The class must not have any sub-classes. 
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Class Exceptions Reference 



ClsDestroySuperClasses( pCls ) 

CLS - 402: pCls must be a valid Cls pointer. 

ClsFindFirstMsg( pCls, pStr ) 

CLS - 446: pQs must be a valid Cls pointer. 

ClsFindFirstSelectorIndex( pCls, pStr ) 

CLS - 490: pQs must be a valid Cls pointer. 

ClsFindMsg( pCls, pStr ) 

CLS - 529: pQs must be a valid Cls pointer. 

ClsFindSelectorIndex( pCls, pStr ) 

CLS - 572: pQs must be a valid Cls pointer. 

ClsFindSuperClass( pCls, pStr ) 

CLS - 609: pQs must be a valid Cls pointer. 

ClsGetMessageCount( pCls ) 

CLS - 641 : pQs must be a valid Cls pointer. 

ClsGetMethodAndOffset( pCls, m, ppMth, pOffset ) 

CLS - 692: pQs must be a valid Cls pointer. 

CLS - 693: The message number must be greater than or equal to zero, and 

less than the number of messages. 

ClsGetName( pCls ) 

CLS - 721 : pCls must be a valid Cls pointer. 
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Class Exceptions Reference 



ClsGetNthMsg( pCls, n ) 

CLS - 755: pCls must be a valid Cls pointer. 

CLS - 756: The message number must be greater than or equal to zero, and 

less than the number of messages. 

ClsGetNthSuperClass( pCls, n ) 

CLS - 788: pCls must be a valid Cls pointer. 

CLS - 789: The super class index must be greater than or equal to zero, and 

less than the number of superclasses. 

ClsGetObjectSize( pCls ) 

CLS - 821 : pCls must be a valid Cls pointer. 

ClsGetOffsetForMsg( pCls, m ) 

CLS - 861: pCls must be a valid Cls pointer. 

CLS - 862: The message number must be greater than or equal to zero, and 

less than the number of messages. 

ClsGetOffsetOfNthSuper( pCls, n ) 

CLS - 899: pQs must be a valid Cls pointer. 

CLS - 900: The super class index must be greater than or equal to zero, and 

less than the number of superclasses. 

ClsGetRootSubClass( pCls ) 

CLS - 932: pQs must be a valid Cls pointer. 

ClsGetRootSubObjectOffset( pCls ) 

CLS - 966: pCls must be a valid Cls pointer. 

ClsGetRootSubObjectSize( pCls ) 

CLS - 998: pCls must be a valid Cls pointer. 
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Class Exceptions Reference 



ClsGetSize( pCls ) 



CLS-1029: 



pOs must be a valid Cls pointer. 



ClsGetSubClass( pCls ) 

CLS - 1061: pQs must be a valid Cls pointer. 



ClsGetSubObjectOffset( pCls ) 



CLS - 1092: 



pCls must be a valid Cls pointer. 



ClsGetSuperClassCount( pCls ) 



CLS -1123: 



pQs must be a valid Cls pointer. 



ClsGetSuperClassIndex( pCls ) 



CLS -1152: 



pCls must be a valid Cls pointer. 



ClsInit(pCls,pMcl) 



CLS -1183 
CLS - 1184: 
CLS -1187: 
CLS -1189 



pMcl must be a valid Mcl pointer. 

pQs must be a valid Cls pointer. 

Not enough memory to allocate superclasses 

Not enough memory to allocate messages 



ClsIsRoot( pCls ) 

CLS -1223: 



pOs must be a valid Cls pointer. 



ClsOffsetSupers( pClsSub, pClsSuper, offset ) 



CLS - 1252: 
CLS - 1253: 



pClsSub must be a valid Cls pointer. 
pClsSuper must be a valid Cls pointer. 



ClsPrint( pCls, pCio, item, level, name ) 

CLS - 1293: pCls must be a valid Cls pointer. 

CLS - 1294: pQo must be a valid Cio pointer. 
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ClsSendDestroy( pCls ) 

CLS - 1327: pQs must be a valid Cls pointer. 

ClsSendObjectMessage( pCls, pObj, m, pBlk ) 

CLS - 1373: pQs must be a valid Cls pointer. 

CLS - 1374: pObj must be a valid Obj pointer. 

CLS - 1375: The message number must be greater than or equal to zero, and 

less than the number of messages. 
CLS - 1376: pBlk must be a valid Blk pointer. 

ClsSendObjectMessageReturnInt( pCls, pObj, m, pBlk ) 

CLS - 1426: pCls must be a valid Cls pointer. 

CLS - 1427: pObj must be a valid Obj pointer. 

CLS - 1428: The message number must be greater than or equal to zero, and 

less than the number of messages. 
CLS - 1429: pBlk must be a valid Blk pointer. 

ClsSendObjectMessageReturnPtr( pCls, pObj, m, pBlk ) 

CLS - 1479: pQs must be a valid Cls pointer. 

CLS - 1480: pObj must be a valid Obj pointer. 

CLS - 1481: The message number must be greater than or equal to zero, and 

less than the number of messages. 
CLS - 1482: pBlk must be a valid Blk pointer. 

ClsSuperClassOf ( pClsSub, pClsSuper, index, offset ) 



CLS -1511 
CLS -1512 
CLS -1513 



pClsSub must be a valid Cls pointer. 
pClsSuper must be a valid Cls pointer. 
pClsSub must not be identical to pClsSuper 



DllAppencK pDll, pLel, pLelApp ) 

DLL - 83: pDll must be a valid Dll pointer. 

DLL - 84: pLelApp must be a valid Lei pointer. 
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Class Exceptions Reference 



DllAppendLast( pDll, pLel ) 



DLL - 118: 
DLL - 119: 



pDll must be a valid DU pointer. 
pLel must be a valid Lei pointer. 



DllAsObj( pDll ) 



DLL - 149: 



pDll must be a valid Dll pointer. 



DUClear( pDll ) 

DLL - 175: 



pDll must be a valid Dll pointer. 



DllCut( pDll, pLel ) 



DLL -208: 
DLL -209: 
DLL -210: 



pDll must be a valid Dll pointer. 
pLel must be a valid Lei pointer. 
pLel must be in the list pDll. 



DllCutChildren( pDU) 

DLL -236: 



pDll must be a valid Dll pointer. 



DllCutRange( pDll, pLelBeg, pLelEnd ) 



DLL - 282; 
DLL -283: 
DLL - 284 
DLL -285: 

DLL - 286: 



pDll must be a valid Dll pointer. 
pLelBeg must be a valid Lei pointer. 
pLelEnd must be a valid Lei pointer. 

If pLelBeg does not equal pLelEnd then pLelBeg must precede 
pLelEnd. 

pLelBeg must be in the list pDll. 



DUDeInit( pDll ) 



DLL -316: 
DLL -317: 
DLL -319: 



pDll must be a valid Dll pointer. 
pDll cannot have any list elements 
pDll must be a valid Dll pointer. 



DllDestroy( pDll ) 



DLL - 348: 
DLL - 349: 



pDll must be a valid Dll pointer. 
pDll must not have a sub-object 
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DllGetClient( pDll, offset ) 

DLL - 384: pDll must be a valid Dll pointer. 

DUGetFirst(pDU) 

DLL - 415: pDll must be a valid Dll pointer. 

DllGetLast(pDll) 

DLL - 447: pDll must be a valid Dll pointer. 

DllGetNth( pDll, index ) 

DT L - 484: pDll must be a valid Dll pointer. 

DllGetSize( pDll) 

DLL - 512: pDll must be a valid Dll pointer. 

Dlllnit( pDll ) 

DLL - 540: pDll must be a valid Dll pointer. 

DUInsert( pDll, pLel, pLellns ) 

DLL - 581 : pDll must be a valid Dll pointer. 

DLL - 582: pLellns must be a valid Lei pointer. 

DUInsertFirst( pDll, pLel ) 

DLL - 615: pDll must be a valid Dll pointer. 

DLL - 616: pLel must be a valid Lei pointer. 

DllIsEmpty( pDll ) 

DLL - 644: pDll must be a valid Dll pointer. 
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DULelClientCount( pDll, offset, pBlk ) 

DLL - 691 : pDll must be a valid DU pointer. 

DLL - 692: pBlk must be a valid Blk pointer. 

DULelCUentFind( pDll, offset, pBlk ) 

DLL - 739: pDll must be a valid DU pointer. 

DLL - 740: pBlk must be a valid Blk pointer. 

DULelCHentFirst( pDll, offset ) 

DLL - 776: pDll must be a valid DU pointer. 

DULelCUentGetNth( pDll, offset, index ) 

DLL - 819: pDll must be a valid DU pointer. 

DllLelClientLast( pDll, offset ) 

DLL - 856: pDll must be a valid DU pointer. 

DULelCHentVisitBwd( pDll, offset, pBlk ) 

DLL - 901: pDU must be a valid DH pointer. 

DLL - 902: pBlk must be a valid Blk pointer. 

DULelCUentVisitFwd( pDll, offset, pBlk ) 

DLL - 946: pDll must be a valid DU pointer. 

DLL - 947: pBlk must be a valid Blk pointer. 

DllNotifyCutRange( pDll, pLelBeg, pLelEnd ) 



DLL -974: 
DLL -975: 
DLL -976: 



pDll must be a valid DU pointer. 
pLelBeg must be a valid Lei pointer. 
pLelEnd must be a valid Lei pointer. 
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DllNotifyPasteRange( pDll, pLelBeg, pLelEnd ) 



DLL -1005 
DLL - 1006; 
DLL -1007: 



pDll must be a valid Dll pointer. 
pLelBeg must be a valid Lei pointer. 
pLelEnd must be a valid Lei pointer. 



DllPasteRangeAfter( pDll, pLel, pLelBeg, pLelEnd ) 



DLL - 1063 
DLL -1064 
DLL -1065 
DLL -1066 

DLL -1067: 
DLL - 1072 
DLL -1073 



pDll must be a valid Dll pointer. 
pLelBeg must be a valid Lei pointer. 
pLelEnd must be a valid Lei pointer. 

If pLelBeg does not equal pLelEnd then pLelBeg must precede 
pLelEnd. 

pLelBeg must not already be in a list. 
pLel must be a valid Lei pointer. 
pLel must be in the list pDll. 



DllPasteRangeBefore( pDll, pLel, pLelBeg, pLelEnd ) 



DLL -1128 
DLL - 1129 
DLL -1130 
DLL -1131 

DLL -1132 
DLL -1137: 
DLL -1138 



pDll must be a valid Dll pointer. 
pLelBeg must be a valid Lei pointer. 
pLelEnd must be a valid Lei pointer. 

If pLelBeg does not equal pLelEnd then pLelBeg must precede 
pLelEnd. 

pLelBeg must not already be in a list. 
pLel must be a valid Lei pointer. 
pLel must be in the list pDll. 



DllPasteRangeFirst( pDll, pLelBeg, pLelEnd ) 



DLL - 1195 
DLL - 1196 
DLL -1197: 



pDll must be a valid Dll pointer. 
pLelBeg must be a valid Lei pointer. 
pLelEnd must be a valid Lei pointer. 



DllPasteRangeLast( pDll, pLelBeg, pLelEnd ) 



DLL -1253: 
DLL -1254: 
DLL -1255: 



pDll must be a valid Dll pointer. 
pLelBeg must be a valid Lei pointer. 
pLelEnd must be a valid Lei pointer. 



DllSendDestroy( pDll ) 



DLL -1282: 



pDll must be a valid Dll pointer. 
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DpaAppend( pDpa, pObj ) 



DPA - 96: 



pDpa must be a valid Dpa pointer. 



DpaClear( p.Dpa ) 



DPA - 122: 



pDpa must be a valid Dpa pointer. 



DpaCount( pDpa, pBlk ) 



DPA - 171: 
DPA - 172: 



pDpa must be a valid Dpa pointer. 
pBlk must be a valid Blk pointer. 



DpaCountRange( pDpa, beg, end, pBlk ) 



DPA - 233: 
DPA - 234: 
DPA - 235: 
DPA - 236: 
DPA - 237: 



pDpa must be a valid Dpa pointer. 
The index beg must be in the range [0-END]. 
The index end must be in the range [0-ENDJ. 
beg must be less than or equal to end. 
pBlk must be a valid Blk pointer. 



DpaDeInit( pDpa ) 



DPA - 271: 
DPA - 274: 



pDpa must be a valid Dpa pointer. 
pDpa must be a valid Dpa pointer. 



DpaDelete( pDpa, beg, n ) 



DPA - 316: 
DPA - 317 
DPA - 318 



pDpa must be a valid Dpa pointer. 

The index beg must be in the range [O-END]. 

(beg + n) must be less than or equal to the size of the array. 



DpaDestroy( pDpa ) 

DPA - 346: 



pDpa must be a valid Dpa pointer. 



DpaExpand( pDpa, beg, n ) 



DPA - 397: 
DPA - 398 
DPA - 399 



pDpa must be a valid Dpa pointer, 
beg must be in the range [0:DpaGetSize] 
n must be greater than zero 
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DpaFind( pDpa, pBlk ) 



DPA - 448: 
DPA-449: 



pDpa must be a valid Dpa pointer. 
pBlk must be a valid Blk pointer. 



DpaFindPtrBwd( pDpa, beg, pObj ) 



DPA - 493: 
DPA -494: 



pDpa must be a valid Dpa pointer. 

The index beg must be in the range [0-END]. 



DpaFindPtrFwd( pDpa, beg, pObj ) 



DPA -539: 
DPA -540: 



pDpa must be a valid Dpa pointer. 

The index beg must be in the range [0-END]. 



DpaFindRangeBwd( pDpa, beg, end, pBlk ) 



DPA -601 
DPA - 602 
DPA - 603 
DPA - 604 



pDpa must be a valid Dpa pointer. 
The index beg must be in the range [0-END]. 
The index end must be in the range [0-END]. 
beg must be less than or equal to end. 



DpaFindRangeFwd( pDpa, beg, end, pBlk ) 



DPA -664: 
DPA -665 
DPA - 666: 
DPA - 667: 



pDpa must be a valid Dpa pointer. 
The index beg must be in the range [0-END]. 
The index end must be in the range [0-END]. 
beg must be less than or equal to end. 



DpaGetNth( pDpa, n ) 



DPA -706: 
DPA - 707: 



pDpa must be a valid Dpa pointer. 

The index n must be in the range [0-END]. 



DpaGetLast( pDpa ) 



DPA - 737: 
DPA - 738: 



pDpa must be a valid Dpa pointer. 

The array must have at least one element 
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DpaGetSize( pDpa ) 



DPA-769: 



pDpa must be a valid Dpa pointer. 



Dpalnit( pDpa, s, i ) 



DPA- 806: 
DPA -807: 
DPA -808 
DPA -810: 



pDpa cannot be NULL 

The increment must be greater than one 

The initial size must be greater than or equal to zero 

pDpa must be a valid Dpa pointer. 



DpaNewArray( pDpa ) 



DPA - 837: 
DPA -846: 
DPA -850 



pDpa must be a valid Dpa pointer. 

The allocated size is not a multiple of the increment 

Not enough memory to allocate array 



DpaResize( pDpa, n ) 



DPA -874: 
DPA -875: 



pDpa must be a valid Dpa pointer. 
N must be greater than or equal to zero 



DpaSetNth( pDpa, index, pObj ) 



DPA - 915: 
DPA - 916: 



pDpa must be a valid Dpa pointer. 

The index index must be in the range [0-END]. 



DpaSetRegionNull( pDpa, beg, n ) 



DPA - 958: 
DPA - 959 
DPA - 960 



pDpa must be a valid Dpa pointer. 

The index beg must be in the range [0-END]. 

(beg + n) must be less than or equal to the size of the array. 



DpaSetSize( pDpa, size ) 



DPA -995: 
DPA -996: 



pDpa must be a valid Dpa pointer. 

The new size must be greater than or equal to zero 



DpaShiftDown( pDpa, n ) 



DPA - 1043: 
DPA - 1044: 



pDpa must be a valid Dpa pointer. 

N must be greater than zero and less than the aray size 
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DpaShL^tUpC pDpa, n ) 



DPA - 1075: pDpa must be a valid Dpa pointer. 

DPA - 1076: N must be greater than zero and less than the array size 



DpaVisit( pDpa, pBlk ) 



DPA - 11 14: pDpa must be a valid Dpa pointer. 

DPA - 11 15: pBlk must be a valid Blk pointer. 



DpaVisitClient( pDpa, offset, pBlk ) 

DPA - 1163: pDpa must be a valid Dpa pointer. 

DPA - 1164: pBlk must be a valid Blk pointer. 



DpaVisitRange( pDpa, beg, end, pBlk ) 



DPA -1216; 
DPA -1217; 
DPA -1218 
DPA -1219 



pDpa must be a valid Dpa pointer. 
The index beg must be in the range [0-END]. 
The index end must be in the range [0-END]. 
beg must be less than or equal to end. 



DpaVisitRegion( pDpa, beg, n, pBlk ) 

DPA - 1272: pDpa must be a valid Dpa pointer. 

DPA - 1273: The index beg must be in the range [0-END1. 

DPA - 1274: (beg + n) must be less than or equal to the size of the array. 



DpaVisitSelf AndSuccessors( pDpa, beg, pBlk ) 

DPA - 1318: pDpa must be a valid Dpa pointer. 

DPA - 1319: The index beg must be in the range [0-END]. 

DPA - 1320: pBlk must be a valid Blk pointer. 



EdgAsGrfLeK pEdg ) 

EDG - 101: pEdg must be a valid Edg pointer. 
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EdgAsInLeK pEdg ) 

EDG - 134: 



pEdg must be a valid Edg pointer. 



EdgAsObj( pEdg ) 

EDG - 166: 



pEdg must be a valid Edg pointer. 



EdgAsOutLeK pEdg ) 



EDG -199: 



pEdg must be a valid Edg pointer. 



EdgClear( pEdg ) 



EDG -223: 
EDG -230: 



pEdg must be a valid Edg pointer. 
Failed to disconnect all vertices 



EdgCompareInVtx( pEdg, pVtx, offset, pBlk ) 



EDG - 289: 
EDG -290: 
EDG -291 



pEdg must be a valid Edg pointer. 
pVtx must be a valid Vtx pointer. 
pBlk must be a valid Blk pointer. 



EdgConnectToGrft pEdg, pGrf ) 



EDG -327: 
EDG -328: 
EDG -329: 
EDG - 330: 



pEdg must be a valid Edg pointer. 

pGrf must be a valid Grf pointer. 

pEdg must not already be linked to a graph. 

pEdg must not be linked to any vertices. 



EdgConnectToVertices( pEdg, pVtxI, pVtxO ) 



EDG -367: 
EDG - 368: 
EDG - 369: 
EDG -370: 
EDG -371 
EDG -372 
EDG - 373 



pEdg must be a valid Edg pointer. 

pVbd must be a valid Vtx pointer. 

pVtxO must be a valid Vtx pointer. 

pEdg must be linked to a graph. 

The Vertex pVtxI must be linked to a graph. 

The Vertex pVtxO must be linked to a graph. 

pEdg must not be linked to any vertices. 
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EdgDeInit( pEdg ) 



EDG - 402: pEdg must be a valid Edg pointer. 

EDG - 403: pEdg must not already be linked to a graph. 

EDG - 404: pEdg must not be linked to any vertices. 

EDG - 410: pEdg must be a valid Edg pointer. 



EdgDestroy( pEdg ) 



EDG - 438: pEdg must be a valid Edg pointer. 

EDG - 439: pEdg must not have a sub-object 



EdgDisconnectFromGrf ( pEdg ) 

EDG - 469: pEdg must be a valid Edg pointer. 

EDG - 470: pEdg must be linked to a graph. 

EDG - 471: pEdg must not be linked to any vertices. 



EdgDisconnectFromVertices( pEdg ) 

EDG - 499: pEdg must be a valid Edg pointer. 

EDG - 500: pEdg must be linked to a graph. 

EDG - 506: pEdg must not be linked to any vertices. 



EdgGetClient( pEdg, offset ) 

EDG - 538: pEdg must be a valid Edg pointer. 

EdgGetGrf ( pEdg ) 

EDG - 569: pEdg must be a valid Edg pointer. 

EdgGetInVtx( pEdg ) 

EDG - 605: pEdg must be a valid Edg pointer. 

EDG - 609: pEdg points to an invalid Vertex 

EdgGetNextIn( pEdg ) 

EDG - 642: pEdg must be a valid Edg pointer. 
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EdgGetNextOut( pEdg ) 



EDG-677: 



EdgGetOutVtx( pEdg ) 



EDG-713: 
EDG - 717: 



pEdg must be a valid Edg pointer. 



pEdg must be a valid Edg pointer. 
pEdg points to an invalid Vertex 



EdgGetVertices( pEdg, ppVtxI, ppVtxO ) 

EDG -760: pEdg must be a valid Edg pointer. 



EdgHasVertices( pEdg ) 

EDG -790: 

EdglnGrf ( pEdg ) 

EDG -821: 

Edglnit( pEdg ) 

EDG -850: 



pEdg must be a valid Edg pointer. 



pEdg must be a valid Edg pointer. 



pEdg must be a valid Edg pointer. 



EdgSendDestroy( pEdg ) 

EDG - 880: pEdg must be a valid Edg pointer. 

EdgUpdateInVtx( pEdg, pVtxI ) 



EDG - 912: 
EDG - 913 
EDG -914 
EDG - 915 



pEdg must be a valid Edg pointer. 
pEdg must be linked to a graph. 
pEdg must be linked to two vertices. 
The Vertex pVtxI must be linked to a graph. 
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EdgUpdateOutVtx( pEdg, pVtxO ) 



EDG-946: 
EDG-947: 
EDG-948: 
EDG-949: 



pEdg must be a valid Edg pointer. 

pEdg must be linked to a graph. 

pEdg must be linked to two vertices. 

The Vertex pVtxO must be linked to a graph. 



Grf AnyCycles( pGrf ) 

GRF -100: 



pGrf must be a valid Grf pointer. 



GrfAsEdgDll( pGrf ) 



GRF -132: 



pGrf must be a valid Grf pointer. 



GrfAsObj(pGrf) 

GRF - 165: 



pGrf must be a valid Grf pointer. 



Grf AsVtxDll( pGrf ) 

GRF -197: 



pGrf must be a valid Grf pointer. 



GrfBasicTopologicalSort( pGrf, keepSort, fwdOnly ) 



GRF -251: 



GrfClear( pGrf ) 



GRF -414 
GRF -419 
GRF -420: 



GrfCountEdg( pGrf ) 



GRF -451: 



pGrf must be a valid Grf pointer. 



pGrf must be a valid Grf pointer. 
Failed to disconnect all vertices 
Failed to disconnect all edges 



pGrf must be a valid Grf pointer. 



GrfCountVtx( pGrf ) 

GRF -481: 



pGrf must be a valid Grf pointer. 
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GrfDeInit( pGrf ) 



GRF -513 
GRF -514 
GRF -515 
GRF -523 



pGrf must be a valid Grf pointer. 
pGrf must not contain any vertices 
pGrf must not contain any edges 
pGrf must be a valid Grf pointer. 



GrfDestroy( pGrf ) 

GRF - 551 : pGrf must be a valid Grf pointer. 

GRF - 552: pGrf must not have a sub-object 

GrfDoTopologicalSort( pGrf ) 

GRF - 588: pGrf must be a valid Grf pointer. 



GrfFindEdgClient( pGrf, offset, pBlk ) 

GRF - 640: pGrf must be a valid Grf pointer. 

GRF - 641 : pBlk must be a valid Blk pointer. 

GrfFindVtxClient( pGrf, offset pBlk ) 

GRF - 693: pGrf must be a valid Grf pointer. 

GRF -694: pBlk must be a valid Blk pointer. 



GrfGetClient( pGrf, offset ) 

GRF - 728: pGrf must be a valid Grf pointer. 

GrflnitC pGrf ) 

GRF - 757: pGrf must be a valid Grf pointer. 



GrfSendDestroy( pGrf ) 

GRF - 789: pGrf must be a valid Grf pointer. 
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GrfVisitEdgClient( pGrf, offset, pBlk ) 

GRF-834: pGrf must be a valid Grf pointer. 

GRF - 835: pBlk must be a valid Blk pointer. 

GrfVisitVtxClient( pGrf, offset, pBlk ) 

GRF -879: pGrf must be a valid Grf pointer. 

GRF -880: pBlk must be a valid Blk pointer. 

GrfVisitVtxCUentInTopOrderBwd( pGrf, offset, pBlk ) 

GRF - 927: pGrf must be a valid Grf pointer. 

GRF - 928: pBlk must be a valid Blk pointer. 

GrfVisitVtxCUentInTopOrderFwd( pGrf, offset, pBlk ) 

GRF - 975: pGrf must be a valid Grf pointer. 

GRF - 976: pBlk must be a valid Blk pointer. 

JulAddDays( pjul, dy ) 

JUL - 68: pjul must be a valid Jul pointer. 

JulAddDaysL( pjul, dy ) 

JUL - 100: pjul must be a valid Jul pointer. 

JulAddMonths( pjul, mnth ) 

JUL - 138: pjul must be a valid Jul pointer. 

JulAddQuarters( pjul, qtrs ) 

JUL - 208: pjul must be a valid Jul pointer. 

JulAddYears( pjul, yr ) 

JUL - 279: pjul must be a valid Jul pointer. 
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JulCalendarToJulian( pjul, year, month, day ) 



JUL -321 
JUL -322 
JUL -323 
JUL -324 



JulCopy( pJulD, pJulS ) 



JUL -364: 
JUL -365: 



pjul must be a valid Jul pointer. 

Year must be in the range [1582:4713] 

Month must be in the range [1:12] 

Day must be a valid day for the month and year specified 



pJulD must be a valid Jul pointer. 
pJulS must be a valid Jul pointer. 



JulDateStrToJulian( pjul, pStr, format ) 

JUL -411: pjul must be a valid Jul pointer. 



JulDayOfWeek( pjul ) 



JUL -454: 



JulDayOfYear( pjul ) 



JUL -489: 



pjul must be a valid Jul pointer. 



pjul must be a valid Jul pointer. 



JulDaysInMonth( pjul ) 

JUL - 532: pjul must be a valid Jul pointer. 

JulDaysInQuarter( pjul ) 

JUL - 577: pjul must be a valid Jul pointer. 



JulDaysInYear( pjul ) 

JUL -624: 

JulDiff(pJull,pJul2) 



JUL -663: 
JUL -664 
JUL - 667 



pjul must be a valid Jul pointer. 



pjull must be a valid Jul pointer. 
pju!2 must be a valid Jul pointer. 
Difference too large for Mediumlnt 



Appendix A -22 



Class Exceptions Reference 



JulDiffL( pjull, pjul2) 

JUL - 703: pjull must be a valid Jul pointer. 

JUL - 704: pjul2 must be a valid Jul pointer. 

JulGetSystemJulianDay( pjul ) 

JUL - 737: pjul must be a valid Jul pointer. 

Jullnit(pjul) 

None 

JulIsLeapYear( yr ) 

None 

JulIsMaxValue( pjul ) 

JUL - 829: pjul must be a valid Jul pointer. 



JulMax( pjul, pjull, pju!2 ) 



JUL -861 
JUL -862 
JUL -863: 



JulMin( pjul, pjull, pju!2 ) 



JUL -894 
JUL -895 
JUL -896: 



pjul must be a valid Jul pointer, 
pjull must be a valid Jul pointer. 
pjul2 must be a valid Jul pointer. 



pjul must be a valid Jul pointer, 
pjull must be a valid Jul pointer. 
pjul2 must be a valid Jul pointer. 



JulMonthDayDiff ( pjul, mnth, dy ) 

JUL - 932: pjul must be a valid Jul pointer. 
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JulMonthString( pjul, pStr ) 

JUL - 979: pjul must be a valid Jul pointer. 



JulQuarterString( pjul, pStr ) 

JUL - 1028: pjul must be a valid Jul pointer. 



JulSameDayMonth( pjull, pjul2 ) 

JUL - 1073: pjull must be a valid Jul pointer. 

JUL - 1074: pjul2 must be a valid Jul pointer. 



JulSetMaxDate( pjul ) 

JUL - 1 107: pjul must be a valid Jul pointer. 



JulToCalendar( pjul, year, month, day ) 

JUL - 1 143: pjul must be a valid Jul pointer. 



JulToDateStr( pjul, pStr, format ) 

JUL - 1218: pjul must be a valid Jul pointer. 



JulValidateDate( pStr, format ) 

None 



JulWeekString( pjul, pStr ) 

JUL - 1328: pjul must be a valid Jul pointer. 



JulYearString( pjul, pStr ) 

JUL - 1375: pjul must be a valid Jul pointer. 



LelAsObjX pLel ) 

LEL - 73: pLel must be a valid Lei pointer. 
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LelClientCount( pLel, offset, pBlk ) 



LEL - 121: The list element can be NULL in which case the return value is 

zero and no items are processed 
LEL - 122: pBlk must be a valid Blk pointer. 

LEL - 125: An invalid listElement pointer was encountered during the 

walk 



LelClientDlK pLel, offset ) 

LEL - 160: pLel must be a valid Lei pointer. 



LelClientFindRange( pLelBeg, pLelEnd, offset, pBlk ) 

LEL - 223: pLelBeg must be a valid Lei pointer. 

LEL - 224: pLelEnd must be a valid Lei pointer. 

LEL - 225: If pLelBeg does not equal pLelEnd then pLelBeg must precede 

pLelEnd. 

LEL - 226: pBlk must be a valid Blk pointer. 

LEL - 231: An invalid List Element pointer was encountered during the 

walk 



LelClientNext( pLel, offset ) 

LEL - 272: pLel must be a valid Lei pointer. 

LelClientPrev( pLel, offset ) 

LEL - 309: pLel must be a valid Lei pointer. 



LelCHentVisitBwd( pLel, offset, pBlk ) 

LEL - 356: The list element may be NULL in which case no elements are 

visited 

LEL - 357: pBlk must be a valid Blk pointer. 

LEL - 360: An invalid ListElement pointer was encountered during the 

walk 
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LelClientVisitFwd( pLel, offset, pBlk ) 

LEL - 408: The list element may be NULL in which case no elements are 

visited 

LEL - 409: pBlk must be a valid Blk pointer. 

LEL - 412: An invalid ListElement pointer was encountered during the 

walk 



LelClientVisitPredecessors( pLel, offset, pBlk ) 

LEL - 459: pLel must be a valid Lei pointer. 

LEL - 460: pBlk must be a valid Blk pointer. 



LelClientVisitRange( pLelBeg, pLelEnd, offset, pBlk ) 

LEL - 520: pLelBeg must be a valid Lei pointer. 

LEL - 521: pLelEnd must be a valid Lei pointer. 

LEL - 522: If pLelBeg does not equal pLelEnd then pLelBeg must precede 

pLelEnd. 

LEL - 523: pBlk must be a valid Blk pointer. 

LEL - 529: An invalid ListElement pointer was encountered during the 

walk 



LelClientVisitSuccessors( pLel, offset, pBlk ) 

LEL - 577: pLel must be a valid Lei pointer. 

LEL - 578: pBlk must be a valid Blk pointer. 



LelCountRange( pLelBeg, pLelEnd ) 

LEL - 621: pLelB must be a valid Lei pointer. 

LEL - 622: pLelE must be a valid Lei pointer. 

LEL - 623: If pLelBeg does not equal pLelEnd then pLelBeg must precede 

pLelEnd. 

LEL - 632: An invalid ListElement pointer was encountered during the 

walk 



LelCut(pLel) 

LEL - 663: pLel must be a valid Lei pointer. 
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LelCutRange( pLelBeg, pLelEnd ) 



LEL-706: 
LEL - 707: 
LEL -708 



pLelBeg must be a valid Lei pointer. 
pLelEnd must be a valid Lei pointer. 

If pLelBeg does not equal pLelEnd then pLelBeg must precede 
pLelEnd. 



LelCutRangeFromList( pLelBeg, pLelEnd ) 



LEL - 745 

LEL - 746: 
LEL - 747: 

LEL - 756: 



pLelBeg must be a valid Lei pointer. 
pLelEnd must be a valid Lei pointer. 

If pLelBeg does not equal pLelEnd then pLelBeg must precede 
pLelEnd. 

An invalid ListElement pointer was encountered while walking 
through the range 



LelDeInit( pLel ) 



LEL -790: 
LEL - 791 
LEL - 792 
LEL - 794 



pLel must be a valid Lei pointer. 

The list element must not be connected to any other elements 
The list element must not be in a list 
pLel is not a valid ListElement pointer 



LelDestroy( pLel ) 



LEL - 824: 
LEL - 825: 



pLel must be a valid Lei pointer. 

The instance must be the outermost subclass; it cannot have a 
sub-object 



LelGetClient( pLel, offset ) 

LEL - 857: pLel must be a valid Lei pointer. 



LelGetDll( pLel ) 

LEL -887: 



pLel must be a valid Lei pointer. 



LelGetNext( pLel ) 



LEL - 917: 



pLel must be a valid Lei pointer. 
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LelGetNthSuccessor( pLel, offset ) 

LEL - 953: pLel must be a valid Lei pointer. 



LelGetPrev( pLel ) 



LEL - 985: 



pLel must be a valid Lei pointer. 



LellnLisK pLel) 

LEL -1014: 



pLel must be a valid Lei pointer. 



Lellnit( pLel ) 

LEL - 1043: 



pLel must be a valid Lei pointer. 



LelPasteRangeAfter( pLel, pLelBeg, pLelEnd ) 



LEL -1090: 
LEL -1091 
LEL - 1092; 
LEL - 1093: 

LEL - 1094: 
LEL -1095: 



pLel must be a valid Lei pointer. 
pLelBeg must be a valid Lei pointer. 
pLelEnd must be a valid Lei pointer. 

If pLelBeg does not equal pLelEnd then pLelBeg must precede 
pLelEnd. 

pLelBeg must not already be in a list. 

pLel cannot be identical to either pLelBeg or pLelEnd 



LelPasteRangeBefore( pLel, pLelBeg, pLelEnd ) 



LEL -1154: 
LEL - 1155 
LEL -1156: 
LEL - 1157: 

LEL -1158: 
LEL -1159: 



pLel must be a valid Lei pointer. 
pLelBeg must be a valid Lei pointer. 
pLelEnd must be a valid Lei pointer. 

If pLelBeg does not equal pLelEnd then pLelBeg must precede 
pLelEnd. 

pLelBeg must not already be in a list. 

pLel cannot be identical to either pLelBeg or pLelEnd 
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LelPasteRangeToList( pLelBeg, pLelEnd, pDll ) 



LEL -1196: 
LEL-1197: 
LEL -1198: 

LEL-1199: 
LEL-1200: 
LEL-1207: 

LEL -1214: 



pLelBeg must be a valid Lei pointer. 
pLelEnd must be a valid Lei pointer. 

If pLelBeg does not equal pLelEnd then pLelBeg must precede 
pLelEnd. 

pLelBeg must not already be in a list 
The list pDll can be NULL 

An invalid ListElement pointer was encountered while walking 

through the range 

pDll must be a valid DU pointer. 



LelSendDestroy( pLel ) 



LEL-1242: 



pLel must be a valid Lei pointer. 



LelTest( pLel ) 



LEL - 1265: 
LEL - 1266: 
LEL - 1269: 
LEL - 1271 



pLel cannot be NULL 

pLel must be a valid Lei pointer. 

The successor list element must point to pLel 

The predecessor list element must point to pLel 



LelVisitRange( pLelBeg, pLelEnd, pBlk ) 



LEL -1318 
LEL - 1319 
LEL - 1320: 

LEL -1321: 
LEL - 1326: 



pLelBeg must be a valid Lei pointer. 
pLelEnd must be a valid Lei pointer. 

If pLelBeg does not equal pLelEnd then pLelBeg must precede 
pLelEnd. 

pBlk must be a valid Blk pointer. 

An invalid ListElement pointer was encountered while walking 
through the range 



MclCreateClass( pMcl ) 



MCL-105: 
MCL-108: 



pMcl must be a valid Mcl pointer. 
Not enough memory to create class 



MclDestroyClass( pMcl, pCls ) 



MCL - 146: 



pMcl must be a valid Mcl pointer. 
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MclFindFirstSelector( pMcl, pStr ) 

MCL - 188: pMcl must be a valid Md pointer. 

MclFindSelector( pMcl, pStr ) 

MCL - 236: An Mms with a pMth — -1 must be followed by same selector 

MclFindSuperClass( pMcl, pStr ) 

MCL - 271: pMcl must be a valid Mcl pointer. 

MclGetClassName( pMcl ) 

MCL -303: pMcl must be a valid Mcl pointer. 

MclGetClassSize( pMcl ) 

MCL - 331 : pMcl must be a valid Mcl pointer. 

MclGetMessageCount( pMcl ) 

MCL - 359: pMcl must be a valid Mcl pointer. 

MclGetNthMms( pMcl, n ) 

MCL - 389: pMcl must be a valid Mcl pointer. 

MCL - 390: The message number must be greater than or equal to zero, and 

less than the number of messages. 

MclGetNthOffset( pMcl, n ) 

MCL - 425: pMcl must be a valid Mcl pointer. 

MCL - 426: The super class index must be greater than or equal to zero, and 

less than the number of superclasses. 

MclGetNthSuper( pMcl, n ) 

MCL - 456: pMcl must be a valid Mcl pointer. 

MCL - 457: The super class index must be greater than or equal to zero, and 

less than the number of superclasses. 



Appendix A - 30 



Class Exceptions Reference 



MclGetObjectSize( pMcl ) 

MCL - 482: pMcl must be a valid Md pointer. 

MclGetSuperClassC6unt( pMcl ) 

MCL - 508: pMcl must be a valid Mcl pointer. 

MclPrint( pMcl, pCio, item, level, name ) 

MCL - 544: pMcl must be a valid Mcl pointer. 

MCL - 545: pCio must be a valid Cio pointer. 

MclSendCreateClass( pMcl ) 

MCL - 586: pMcl must be a valid Mcl pointer. 

MCL - 593: pMcl failed to create the class 

MclSendDestroyClass( pMcl, pCls ) 

MCL - 617: pMcl must be a valid Mcl pointer. 

MclValidate(pMcl) 

MCL - 650: pMcl must be a valid Mcl pointer. 



MCL -652 
MCL -653 
MCL -654 
MCL -657: 
MCL -658 



The name component must not be NULL 

The number of messages must be in the range [0:100] 

The number of superclasses must be in the range [0:30] 

A create function must be supplied 

A destroy function must be supplied 



MclValidateMessages( pMcl ) 

MCL - 690: pMcl must be a valid Mcl pointer. 

MclValidateSuperClasses( pMcl ) 

MCL - 726: pMcl must be a valid Mcl pointer. 
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MemClear( pMem, s, i, n, os ) 



MEM -86: 
MEM -87: 
MEM -88: 
MEM -89: 



pMem must be a valid Mem pointer, 
i must be less s. 

(i + n) must be less or equal to s. 
os must be greater than 0. 



MemCopy( pMem, s, di, n, i, os ) 



MEM -128: 
MEM - 129: 
MEM -130: 
MEM -131 
MEM -132: 
MEM -133: 



pMem must be a valid Mem pointer, 
i must be less s. 

(i + n) must be less or equal to s. 

os must be greater than 0. 

di must be less s. 

(di + n) must be less or equal to s. 



MemCutNSet( pMem, s, i, n, os, c ) 



MEM - 174 
MEM - 175: 
MEM - 176: 
MEM - 177: 



pMem must be a valid Mem pointer, 
i must be less s. 

(i + n) must be less or equal to s. 
os must be greater than 0. 



MemDestroy( pMem ) 



MEM -216: 



pMem must be a valid Mem pointer. 



MemDuplicate( pMem, s, pMemS, os ) 

MEM - 246: pMem must be a valid Mem pointer. 

MEM - 247: pMemS must be a valid Mem pointer. 

MEM - 248: os must be greater than 0. 



MemNew( amount ) 

None 



MemNe wFast( amount ) 

None 
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MemPasteNSet( pMem, s, i, n, os, c ) 

* 

MEM - 363: pMem must be a valid Mem pointer. 

MEM - 364: i must be less s. 

MEM - 365: (i + n) must be less or equal to s. 

MEM - 366: os must be greater than 0. 



MemSetChr( pMem, s, i, n, os, c ) 



MEM -403: 
MEM -404: 
MEM -405 
MEM -406: 



pMem must be a valid Mem pointer, 
i must be less s. 

(i + n) must be less or equal to s. 
os must be greater than 0. 



MmsGetMethod( pMms ) 

MMS - 88: pMms must be a valid Mms pointer. 



MmsGetSuper( pMms ) 



MMS - 144: 



pMms must be a valid Mms pointer. 



MmsGetSelector( pMms ) 

MMS - 181: pMms must be a valid Mms pointer. 



MmsPrint( pMms, pCio, item, level, name ) 



MMS -214: 
MMS -215: 



pMms must be a valid Mms pointer. 
pCio must be a valid Go pointer. 



MmsValidate( pMms ) 



MMS -246: 
MMS -248: 



pMms must be a valid Mms pointer. 
pMms->selector must be a valid Str pointer. 



MscGetName( pMsc ) 

MSC - 79: 



pMsc must be a valid Msc pointer. 
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MscGetMetaClass( pMsc ) 

MSC - 109: pMsc must be a valid Msc pointer. 



MscGetOffset( pMsc ) 



MSC - 143: 
MSC -146: 



pMsc must be a valid Msc pointer. 

The superobject offset must be in the range 10:2000] 



MscPrint( pMsc, pCio, item, level, name ) 



MSC -178: 
MSC - 179: 



pMsc must be a valid Msc pointer. 
pCio must be a valid Go pointer. 



MscValidate( pMsc ) 



MSC - 215 
MSC -217: 
MSC -218 
MSC -219 
MSC - 220: 
MSC -221 



pMsc must be a valid Msc pointer. 

A name must be supplied 

A valid MetaQas pointer must be supplied 

A pointer to an instance of the super-object must be supplied 

A pointer to an instance of the super-object must be supplied 

A pointer to a Mediumlnt must be supplied 



MsgDeInit( pMsg ) 



MSG -80: 
MSG - 81: 



pMsg must be a valid Msg pointer. 
pMsg must be a valid Msg pointer. 



MsgGetOffset( pMsg ) 



MSG - 106: 



pMsg must be a valid Msg pointer. 



MsgGetMethod( pMsg ) 



MSG - 133: 



pMsg must be a valid Msg pointer. 



MsgGetSelector( pMsg ) 

MSG - 160: pMsg must be a valid Msg pointer. 
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Msglnit( pMsg, pCls, pMms ) 



MSG -190; 
MSG -191 
MSG - 192 
MSG - 208: 

MSG - 205: 
MSG -208: 
MSG - 212: 



pQs must be a valid Cls pointer. 
pMms must be a valid Mms pointer. 
pMsg must be a valid Msg pointer. 

The superclass name referred to by pMms is not a superclass of 
pCls 

The selector is invalid for the superclass named by pMms 
pMms cannot override the selector named 
pMms cannot inherit the selector named 



MsgPrint( pMsg, pCio, item, level, name ) 

MSG - 249: pMsg must be a valid Msg pointer. 

MSG - 250: pCio must be a valid Cio pointer. 



MsgSend( pMsg, pObj, pBlk ) 

MSG - 286: pMsg must be a valid Msg pointer. 

MSG - 287: pBlk must be a valid Blk pointer. 



MsgSendRetumInt( pMsg, pObj, pBlk ) 

MSG - 319: pMsg must be a valid Msg pointer. 

MSG - 320: pBlk must be a valid Blk pointer. 

MsgSendReturnPtr( pMsg, pObj, pBlk ) 

MSG - 352: pMsg must be a valid Msg pointer. 

MSG - 353: pBlk must be a valid Blk pointer. 



MsgSetSuperOffsetAndMethod( pMsg, pMsgSuper ) 

MSG - 382: pMsg must be a valid Msg pointer. 

MSG - 383: pMsgSuper must be a valid Msg pointer. 



ObjDeInit( pObj ) 



OBJ - 83: pObj must be a valid Obj pointer. 

OBJ - 85: pObj must be a valid Obj pointer. 
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ObjDestroy( pObj ) 

OBJ - 1 16: pObj must be a valid Obj pointer. 

ObjGetClient( pObj, offset ) 

OBJ - 155: pObj must be a valid Obj pointer. 

ObjGetCHentOrNuU( pObj, offset ) 

OBJ - 198: pObj may be NULL 

ObjGetCls( pObj ) 

OBJ - 225: pObj must be a valid Obj pointer. 

ObjGetClsName( pObj ) 

OBJ - 252: pObj must be a valid Obj pointer. 

ObjGetImmediateClient( pObj ) 

OBJ -282: pObj must be a valid Obj pointer. 

ObjGetMethodAndOffset( pObj, m, ppMth, pOffset ) 

OBJ - 324: pObj must be a valid Obj pointer. 

OBJ - 325: The message number must be greater than or equal to zero, and 

less than the number of messages. 

ObjGetNthSuperObject( pObj, n ) 

OBJ - 354: pObj must be a valid Obj pointer. 

OBJ - 355: The super class index must be greater than or equal to zero, and 

less than the number of superclasses. 

ObjGetRootClient( pObj ) 

OBJ - 386: pObj must be a valid Obj pointer. 
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ObjGetRootClientSize( pObj ) 

OBJ - 415: pObj must be a valid Obj pointer. 

ObjGetSize(pObj) 

OBJ -442: pObj must be a valid Obj pointer. 

ObjGetSubObjectOffset( pObj ) 

OBJ - 471: pObj must be a valid Obj pointer. 

ObjInit( pObj, pCls ) 

OBJ - 506: pQs must be a valid Cls pointer. 

OBJ - 507: pObj must be a valid Obj pointer. 

ObjIsRoot( pObj ) 

OBJ - 536: pObj must be a valid Obj pointer. 

ObjRespondsToSelector( pObj, pStr ) 

OBJ - 567: pObj must be a valid Obj pointer. 

ObjSendMessage( pObj, m, pBlk ) 

OBJ - 598: pObj must be a valid Obj pointer. 

OBJ - 599: The message number must be greater than or equal to zero, and 

less than the number of messages. 
OBJ - 600: pBlk must be a valid Blk pointer. 

ObjSendMessageReturnInt( pObj, m, pBlk ) 

OBJ - 635: pObj must be a valid Obj pointer. 

OBJ - 636: The message number must be greater than or equal to zero, and 

less than the number of messages. 
OBJ - 637: pBlk must be a valid Blk pointer. 
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ObjSendMessageReturnPtr( pObj, m, pBlk ) 

OBJ - 672: pObj must be a valid Obj pointer. 

OBJ - 673: The message number must be greater than or equal to zero, and 

less than the number of messages. 
OBJ - 674: pBlk must be a valid Blk pointer. 



StrBasicExtract( pStrD, pStrS, index, length ) 

STR - 62: pStrD must be a valid Str pointer. 

STR - 63: pStrS must be a valid Str pointer. 



StrExtract( pStrD, pStrS, idx, n ) 

STR - 111: pStrD must be a valid Str pointer. 

STR - 1 12: pStrS must be a valid Str pointer. 

StrFromDate( pStr, format, year, month, day ) 

STR - 165: pStr must be a valid Str pointer. 

STR - 178: Invalid format 



StrFromMediumInt( pStr, maxLen, num ) 

STR - 215: pStr must be a valid Str pointer. 



Strlnit( pStr ) 

STR - 248: pStr must be a valid Str pointer. 



StrReplaceSubStr( pStrOrg, pStrFrom, pStrTo, maxLen ) 



STR - 285: 
STR - 286: 
STR -287: 
STR - 288: 



pStrOrg must be a valid Str pointer. 
pStrFrom must be a valid Str pointer. 
pStrTo must be a valid Str pointer. 
maxLen must be in the range [0:128] 



StrSet( pStrD, pStrS ) 



STR - 329: 
STR - 330: 



pStrD must be a valid Str pointer. 
pStrS must be a valid Str pointer. 
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StrSqueeze( pStrD, pStrS, ch ) 

STR - 360: s must be a valid Str pointer. 

STR - 361: pStrD must be a valid Str pointer. 

StrToDate( pStr, format, year, month, day ) 

STR - 412: pStr must be a valid Str pointer. 

STR - 413: The length of pStr must be less than 12 

STR -427: Invalid format 



StrToLower( pStr ) 

STR - 452: pStr must be a valid Str pointer. 

StrToMediumInt( pStr ) 

STR -483: 



StrToUpper( pStr ) 

STR -509: 

TreAsDll( pTre ) 

TRE-80: 

TreAsLeK pTre ) 

TRE - 113: 

TreAsObj( pTre ) 

None 

TreClear( pTre ) 

TRE -168: 
TRE - 172: 
TRE - 177: 
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pStr must be a valid Str pointer. 



pStr must be a valid Str pointer. 



pTre must be a valid Tre pointer. 



pTre must be a valid Tre pointer. 



pTre must be a valid Tre pointer. 
pTre must have no child nodes. 
pTre must be the root node. 
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TreClient( pTre, offset ) 

TRE - 214: pTre must be a valid Tre pointer. 

TreClientFindChild( pTre, offset, pBlk ) 

TRE -266: pTre must be a valid Tre pointer. 

TreClientFirstChild( pTre, offset ) 

TRE -307: pTre must be a valid Tre pointer. 

TreClientLastChild( pTre, offset ) 

TRE -348: pTre must be a valid Tre pointer. 

TreClientLastLeaf ( pTre, offset ) 

TRE - 391 : pTre must be a valid Tre pointer. 

TreClientNext( pTre, offset ) 

TRE - 432: pTre must be a valid Tre pointer. 

TreClientNextPreOrder( pTre, offset ) 

TRE -475: pTre must be a valid Tre pointer. 

TreClientNexlUncle( pTre, offset ) 

TRE - 51 9: pTre must be a valid Tre pointer. 

TreClientParent( pTre, offset ) 

TRE - 559: pTre must be a valid Tre pointer. 
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TreClientPrev( pTre, offset ) 

TRE - 600: pTre must be a valid Tre pointer. 



TreClientPrevPreOrder( pTre, offset ) 

TRE - 643: pTre must be a valid Tre pointer. 



TreClientVisitBranchInOrder( pTre, offset, pBlk ) 

TRE - 695: pTre must be a valid Tre pointer. 

TRE - 696: pBlk must be a valid Blk pointer. 



TreClientVisitChildren( pTre, offset, pBlk ) 

TRE - 751 : pTre must be a valid Tre pointer. 

TRE - 752: pBlk must be a valid Blk pointer. 



TreCUentVisitChUdrenBwd( pTre, offset, pBlk ) 

TRE - 805: pTre must be a valid Tre pointer. 

TRE - 806: pBlk must be a valid Blk pointer. 



TreClientVisitDescBranchInOrder( pTre, offset, pBlk ) 

TRE - 862: pTre must be a valid Tre pointer. 

TRE - 863: pBlk must be a valid Blk pointer. 



TreClientVisitDescInOrder( pTre, offset, pBlk ) 

TRE - 922: pTre must be a valid Tre pointer. 

TRE - 923: pBlk must be a valid Blk pointer. 

TreCUentVisitDescInOrderBwd( pTre, offset, pBlk ) 

TRE - 982: pTre must be a valid Tre pointer. 

TRE - 983: pBlk must be a valid Blk pointer. 
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TreClientVisitDescLeaves( pTre, offset, pBlk ) 

TRE - 1041 : pTre must be a valid Tre pointer. 

TRE - 1042: pBlk must be a valid Blk pointer. 



TreClientVisitDescPreOrder( pTre, offset, pBlk ) 

TRE - 1 100: pTre must be a valid Tre pointer. 

TRE - 1101 : pBlk must be a valid Blk pointer. 



TreClientVisitInOrder( pTre, offset, pBlk ) 

TRE - 1 157: pTre must be a valid Tre pointer. 

TRE - 1158: pBlk must be a valid Blk pointer. 



TreClientVisitInOrderBwd( pTre, offset, pBlk ) 

TRE - 1212: pTre must be a valid Tre pointer. 

TRE - 1213: pBlk must be a valid Blk pointer. 



TreClientVisitLeaves( pTre, offset, pBlk ) 

TRE - 1266: pTre must be a valid Tre pointer. 

TRE - 1267: pBlk must be a valid Blk pointer. 



TreClientVisitParents( pTre, offset, pBlk ) 

TRE - 1323: pTre must be a valid Tre pointer. 

TRE - 1324: pBlk must be a valid Blk pointer. 



TreClientVisitPreOrder( pTre, offset, pBlk ) 

TRE - 1379: pTre must be a valid Tre pointer. 

TRE - 1380: pBlk must be a valid Blk pointer. 



TreClientVisitRange( pTreBeg, pTreEnd, offset, pBlk ) 



TRE - 1445 
TRE - 1446; 
TRE - 1447: 

TRE - 1448: 



pTreBeg must be a valid Tre pointer. 
pTreEnd must be a valid Tre pointer. 

If pTreBeg does not equal pTreEnd then pTreBeg must precede 
pTreEnd. 

pBlk must be a valid Blk pointer. 
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TreClientVisitSuccPreOrder( pTre, offset, pBlk ) 

TRE - 1503: pTre must be a valid Tre pointer. 

TRE - 1504: pBlk must be a valid Blk pointer. 

TRE - 1508: An invalid Tree pointer was encountered while walking the tree 



TreClientVisitSuccessors( pTre, offset, pBlk ) 

TRE - 1561 : pTre must be a valid Tre pointer. 

TRE - 1562: pBlk must be a valid Blk pointer. 



TreCutChildren( pTre ) 

TRE - 1591: pTre must be a valid Tre pointer. 



TreCutRange( pTreBeg, pTreEnd ) 

TRE - 1632: pTreBeg must be a valid Tre pointer. 

TRE - 1633: pTreEnd must be a valid Tre pointer. 

TRE - 1634: If pTreBeg does not equal pTreEnd then pTreBeg must precede 

pTreEnd. 



TreDeInit( pTre ) 



TRE -1663: 
TRE -1664 
TRE -1665 
TRE -1669: 



pTre must be a valid Tre pointer. 
pTre must be the root node. 
pTre must have no child nodes. 
pTre must be a valid Tre pointer. 



TreDestroy( pTre ) 

TRE - 1697: 
TRE - 1698: 



pTre must be a valid Tre pointer. 
pTre must not have a sub-object 



TreDestroyChildren( pTre ) 

TRE - 1730: pTre must be a valid Tre pointer. 
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TreFirstChild( pTre ) 

TRE - 1764: 



pTre must be a valid Tre pointer. 



TreHasChildren( pTre ) 

TRE - 1794: pTre must be a valid Tre pointer. 

TreHasSiblings( pTre ) 

TRE - 1825: pTre must be a valid Tre pointer. 



Trelnit( pTre ) 

TRE -1854: 

TreIsChild( pTre ) 

TRE -1884: 



pTre must be a valid Tre pointer. 



pTre must be a valid Tre pointer. 



TreIsDirectAncestor( pTre, pTreA ) 



TRE - 1920: 
TRE - 1921: 



TrelsRooK pTre ) 

TRE - 1957: 

TreLastChild( pTre ) 

TRE - 1990: 

TreLastLeaf ( pTre ) 

TRE - 2026: 
TRE - 2031: 



pTre must be a valid Tre pointer. 
pTreA must be a valid Tre pointer. 



pTre must be a valid Tre pointer. 



pTre must be a valid Tre pointer. 



pTre must be a valid Tre pointer. 

An invalid Tree pointer was encountered while walking the tree 
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TreNext( pTre ) 

TRE-2063: 



pTre must be a valid Tre pointer. 



TreNextPreOrder( pTre ) 

TRE - 2097: 



pTre must be a valid Tre pointer. 



TreNextUncle( pTre ) 



TRE - 2138: 
TRE - 2142: 



pTre must be a valid Tre pointer. 

An invalid Tree pointer was encountered while walking the tree 



TreParent( pTre ) 

TRE -2178: 



pTre must be a valid Tre pointer. 



TrePasteRangeAfterSibling( pTre, pTreBeg, pTreEnd ) 



TRE -2226 
TRE - 2227: 
TRE - 2228 
TRE -2229 
TRE - 2230 

TRE -2231: 



pTre must be a valid Tre pointer. 
pTre must be a parent. 
pTreBeg must be a valid Tre pointer. 
pTreEnd must be a valid Tre pointer. 

If pTreBeg does not equal pTreEnd then pTreBeg must precede 
pTreEnd. 

pTreBeg must be the root node. 



TrePasteRangeBeforeSibling( pTre, pTreBeg, pTreEnd ) 



TRE -2279 
TRE - 2280: 
TRE -2281 
TRE - 2282 
TRE - 2283 

TRE - 2284: 



pTre must be a valid Tre pointer. 
pTre must be a parent. 
pTreBeg must be a valid Tre pointer. 
pTreEnd must be a valid Tre pointer. 

If pTreBeg does not equal pTreEnd then pTreBeg must precede 
pTreEnd. 

pTreBeg must be the root node. 
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TrePasteRangeFirstChild( pTre, pTreBeg, pTreEnd ) 



TRE-2331 
TRE - 2332 
TRE -2333 
TRE -2334: 

TRE -2335: 



pTre must be a valid Tre pointer. 
pTreBeg must be a valid Tre pointer. 
pTreEnd must be a valid Tre pointer. 

If pTreBeg does not equal pTreEnd then pTreBeg must precede 
pTreEnd. 

pTreBeg must be the root node. 



TrePasteRangeLastChild( pTre, pTreBeg, pTreEnd ) 



TRE -2382 
TRE -2383 
TRE -2384 
TRE - 2385 

TRE -2386: 



pTre must be a valid Tre pointer. 
pTreBeg must be a valid Tre pointer. 
pTreEnd must be a valid Tre pointer. 

If pTreBeg does not equal pTreEnd then pTreBeg must precede 
pTreEnd. 

pTreBeg must be the root node. 



TrePrev( pTre ) 

TRE - 2419: 



pTre must be a valid Tre pointer. 



TrePrevPreOrder( pTre ) 

TRE - 2456: pTre must be a valid Tre pointer. 



TreSendDestroy( pTre ) 



TRE - 2488: 



pTre must be a valid Tre pointer. 



TreVisitBranchInOrder( pTre, pBlk ) 



TRE - 2535: 
TRE -2536: 



pTre must be a valid Tre pointer. 
pBlk must be a valid Blk pointer. 



TreVisitChildren( pTre, pBlk ) 



TRE - 2581: 
TRE - 2582: 



pTre must be a valid Tre pointer. 
pBlk must be a valid Blk pointer. 
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TreVisitChildrenBwd( pTre, pBlk ) 

TRE - 2627: pTre must be a valid Tre pointer. 

TRE - 2628: pBlk must be a valid Blk pointer. 

TreVisitDescBranchInOrder( pTre, pBlk ) 

TRE - 2674: pTre must be a valid Tre pointer. 

TRE - 2675: pBlk must be a valid Blk pointer. 

TreVisitDescInOrder( pTre, pBlk ) 

TRE - 2720: pTre must be a valid Tre pointer. 

TRE - 2721 : pBlk must be a valid Blk pointer. 

TreVisitDescInOrderBwd( pTre, pBlk ) 

TRE - 2766: pTre must be a valid Tre pointer. 

TRE - 2767: pBlk must be a valid Blk pointer. 

TreVisitDescPreOrder( pTre, pBlk ) 

TRE - 281 1 : pTre must be a valid Tre pointer. 

TRE - 2812: pBlk must be a valid Blk pointer. 

TreVisitInOrder( pTre, pBlk ) 

TRE - 2857: pTre must be a valid Tre pointer. 

TRE - 2858: pBlk must be a valid Blk pointer. 

TreVisitInOrderBwd( pTre, pBlk ) 

TRE - 2903: pTre must be a valid Tre pointer. 

TRE - 2904: pBlk must be a valid Blk pointer. 

TreVisitLeaves( pTre, pBlk ) 

TRE - 2948: pTre must be a valid Tre pointer. 

TRE - 2949: pBlk must be a valid Blk pointer. 
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TreVisitParents(pTre,pBlk ) 



TRE - 2992: pTre must be a valid Tre pointer. 

TRE - 2993: pBlk must be a valid Blk pointer. 

TreVisitPreOrder( pTre, pBlk ) 

TRE - 3038: pTre must be a valid Tre pointer. 

TRE - 3039: pBlk must be a valid Blk pointer. 

TreVisitRange( pTreBeg, pTreEnd, pBlk ) 

TRE - 3093: pTreBeg must be a valid Tre pointer. 

TRE - 3094: pTreEnd must be a valid Tre pointer. 

TRE - 3095: If pTreBeg does not equal pTreEnd then pTreBeg must precede 

pTreEnd. 

TRE - 3096: pBlk must be a valid Blk pointer. 

TreVisitSuccPreOrder( pTre, pBlk ) 

TRE - 3140: pTre must be a valid Tre pointer. 

TRE - 3141 : pBlk must be a valid Blk pointer. 

TreVisitSuccessors( pTre, pBlk ) 

TRE - 3186: pTre must be a valid Tre pointer. 

TRE - 3187: pBlk must be a valid Blk pointer. 

TskBasicAssert( condition, fileName, lineNo ) 

None 

TskCondition( pTsk, type, error, fileName, lineNo ) 



TSK-122 
TSK-123 
TSK - 124 
TSK-125 



pTsk must be a valid Tsk pointer. 

The exception stack must not be empty for the Task pTsk. 
There must be no recursion of the exception. 
The condition category must be valid. 
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TskDeInit( pTsk ) 

TSK - 159: pTsk must be a valid Tsk pointer. 

TSK - 163: pTsk must be a valid Tsk pointer. 

TskDefaultInitDos( pTsk, argc, argv ) 

None 

TskExit( pTsk, exitVal ) 

TSK - 241 : pTsk must be a valid Tsk pointer. 

TskExitWithMsg( pTsk, msg ) 

TSK - 288: pTsk must be a valid Tsk pointer. 

TskGetArgc( pTsk ) 

TSK - 315: pTsk must be a valid Tsk pointer. 

TskGetArgv( pTsk ) 

TSK -345: pTsk must be a valid Tsk pointer. 

TskGetExceptionCondition( pTsk ) 

TSK - 376: pTsk must be a valid Tsk pointer. 

TskGetExceptionFileName( pTsk ) 

TSK - 408: pTsk must be a valid Tsk pointer. 

TskGetExceptionLineNo( pTsk ) 

TSK - 439: pTsk must be a valid Tsk pointer. 

TskGetExceptionType( pTsk ) 

TSK - 468: pTsk must be a valid Tsk pointer. 
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TskInitDos( pTsk, argc, argv, maxNesting, excFilter ) 

TSK - 518: pTsk must be a valid Tsk pointer. 

Tsklslnitialized( Void ) 

None 

TskLogCond( pTsk, error ) 

None 

TskMainLogCond( error ) 

None 

TskMainPreCond( error ) 

None 

TskMainPtrCond( error ) 

None 

TskMainRaiseException( error ) 

None 

TskNormalExit( pTsk ) 

TSK - 776: pTsk must be a valid Tsk pointer. 

TskOnException( pTsk ) 

None 
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TskPopExceptionHandler( pTsk ) 



TSK - 854: pTsk must be a valid Tsk pointer. 

T5K - 855: The exception stack must not be empty for the Task pTsk. 

TskPreCond( pTsk, error ) 

None 

TskPrintException( pTsk ) 

TSK -918: pTsk must be a valid Tsk pointer. 

TskPropagateException( pTsk, useFilter ) 



TSK -952; 
TSK -953: 
TSK -954 



pTsk must be a valid Tsk pointer. 

The exception stack must not be empty for the Task pTsk. 

There must be no recursion of the exception. 



TskPtrCond( pTsk, error ) 

None 

TskPushExh( pTsk ) 

TSK - 1025: pTsk must be a valid Tsk pointer. 

TSK - 1 026: The exception stack must not be full for the Task pTsk. 

TskRaiseException( pTsk, error ) 

None 

VtxAsGrfLeK pVtx ) 

VTX - 95: pVtx must be a valid Vtx pointer. 

VtxAsInDll( pVtx ) 

VTX - 127: pVtx must be a valid Vtx pointer. 
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VtxAsObj( pVtx ) 

VTX-160: 



pVtx must be a valid Vtx pointer. 



VtxAsOutDU(pVtx) 

VTX -192: 



pVtx must be a valid Vtx pointer. 



VtxClear( pVtx ) 



VTX -219: 
VTX -225 
VTX -229 



pVtx must be a valid Vtx pointer. 

Failed to disconnect from edges 

pVtx cannot have edges without being in a Graph 



VtxConnectToGrf ( pVtx, pGrf ) 



VTX -257: 
VTX -258 
VTX -259 
VTX -260: 



pVtx must be a valid Vtx pointer. 

pGrf must be a valid Grf pointer. 

pVtx must not already be linked to a graph. 

pVtx must have no edges. 



VtxCountIn( pVtx ) 

VTX -291: 



pVtx must be a valid Vtx pointer. 



VtxCountOut( pVtx ) 



VTX -322: 



pVtx must be a valid Vtx pointer. 



VtxDeInit( pVtx ) 



VTX -354 
VTX -355 
VTX -356: 
VTX -362: 



pVtx must be a valid Vtx pointer. 

pVtx must have no edges. 

pVtx must not already be linked to a graph. 

pVtx must be a valid Vtx pointer. 



VtxDestroy( pVtx ) 



VTX -390: 
VTX -391: 



pVtx must be a valid Vtx pointer. 
pVtx must not have a sub-object 
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VtxDisconnectFromGrf( pVtx ) 



VTX-421 
VTX-422 
VTX -423 



pVtx must be a valid Vtx pointer. 
pVtx must be linked to a graph. 
pVtx must have no edges. 



VtxFindOutEdg( pVtxO, pVtxI, offset, pBlk ) 



VTX -490: 
VTX -491 
VTX -492; 



pVtxO must be a valid Vtx pointer. 
pVtxI must be a valid Vtx pointer. 
pBlk must be a valid Blk pointer. 



VtxFindOutEdgClient( pVtxO, pVtxI, offset, pBlk ) 



VTX -563 
VTX -564 
VTX -565 



pVtxO must be a valid Vtx pointer. 
pVtxI must be a valid Vtx pointer. 
pBlk must be a valid Blk pointer. 



VtxGetClient( pVtx, offset ) 

VTX - 599: pVtx must be a valid Vtx pointer. 



VtxGetFirstIn( pVtx ) 

VTX -631: 

VtxGetFirstOut( pVtx ) 

VTX - 663: 

VtxGetGrf ( pVtx ) 

VTX -692: 

Vtxlnit( pVtx ) 

VTX -721: 

VtxInGrf( pVtx ) 

VTX -751: 



pVtx must be a valid Vtx pointer. 



pVtx must be a valid Vtx pointer. 



pVtx must be a valid Vtx pointer. 



pVtx must be a valid Vtx pointer. 



pVtx must be a valid Vtx pointer. 
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VtxSendDestroy( pVtx ) 

VTX - 780: pVtx must be a valid Vtx pointer. 

VtxStackSetup( pVtx, inStack, outStack, stackVtx, i ) 

VTX - 809: pVtx must be a valid Vtx pointer. 



VtxVisitEdge( pVtx, pBlk ) 

VTX - 847: pVtx must be a valid Vtx pointer. 

VTX - 848: pBlk must be a valid Blk pointer. 



VtxVisitEdgeClient( pVtx, offset, pBlk ) 

VTX - 889: pVtx must be a valid Vtx pointer. 

VTX - 890: pBlk must be a valid Blk pointer. 



VtxVisitInEdge( pVtx, pBlk ) 

VTX - 926: pVtx must be a valid Vtx pointer. 

VTX - 927: pBlk must be a valid Blk pointer. 



VtxVisitInEdgeClient( pVtx, offset, pBlk ) 

VTX - 969: pVtx must be a valid Vtx pointer. 

VTX - 970: pBlk must be a valid Blk pointer. 



VtxVisitOutEdge( pVtx, pBlk ) 

VTX - 1006: pVtx must be a valid Vtx pointer. 



VtxVisitOutEdgeClient( pVtx, offset, pBlk ) 

VTX - 1048: pVtx must be a valid Vtx pointer. 
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